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1.0 ££M££iL 

r. 1 ESi£i££-II3-CyE£iiI-£l3IIIQII«iSi£.ILai££«Sil£f I.£flfi.fi4Iil 

Bof hardcopy of th« SIS, ^o <$N452/125 In SVL# SN302 In ARHls 

acqu I re* s 2i96/yn*dcs 

ses.print s2i96 
For copy on i.5" x ll" Inch paper (In SVt)* add print paraweter fc»sp« 
CYou jnay liare to wait until evening for copjf*} 

For current status of pending SIS daps> see file SIS0APS/pi«o0336 on SN4i2. 

A0SC/8CCS mpproyBd SIS 46ps Incorporated In this revision ere? 

I 
S5036 Cfiange the Key parameter Jkllson) I 

S5048 Keypolnt Ranges CHages) I 

S50i9 Statistics INeyliaysl I 

$§060 Frodyct Identifiers for C0CNET5 DC $. HP CRynd<iylst) I 

SS062 Product Identifier for Distrilbyted Files? OF CSprandell I 

S5067 Passing BIT data tfpe parametars CSarnear} I 

I 
In a^dltlon^ the fol lowing pending 3IS daPs are conditionally Included^ | 

I 
$5102 Product Identifier for Concurrent Halntenance Utilltless CU IRedlfl • 

$fl03 Product Identifier for CYBIl Formatter* CF cyachutkal I 

The fol!o**lng notes will enable you to look at updated sections of the SIS 
wittiout printing the entire docuroents 

I 
For SI 036* see section 2 .a* 4. 3* change In KEY prarseter, 
Bor S5059# see section 3 •5.4 Statistics* 
For Product identifiers* see section 4»1.1«1« 

For S5048# see section 4»7«2»1 Operating System Keypoint ranges* 
For S506 7# see sections 3«2«1«1 and 5«2«5«2 Cinciydlns Its sybsectionsl* 
1.2 £iji£l££ 

1,2a PURPOSE 

The purpose of this standard Is to ensure a uniformity across the operating 
system and product set thst tilll maNe the total system more easily usable and 
human engineered* 

1.2.2 SCOPE 

This standard covers the software system wlslch Includes both the operating 
system and the product set. The standard covers product-to-product* 
product~to~aser> operating system-to-user* and product-to-operatIng systew 
l^nter faces* These Interfaces lay be documented In tl^e RQS/VE and product 
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1.0 GEHERAi 
1.2.2 SCOPE 

ERSs. Tills Syst€« Interface Standard Is the control litis ^locwwent for all sycli 
Interfaces. 

Any external Interface itfilch Is not defined b^ an Industry standard m%y be 
defined In tills Ststei Interface Standard* In order to aelilete a unlforwlty 
across tlie product setj certain Internal Interfaces sliall ba Included In this 
standards e»g« calling sequences* 

WItli respect to coiRffland-ley el calling sequences^ paranetersj and options^ tills 
standard Includes (see section 2.2«4) all options for all parantters of all 
calling sequences aiccept those of NOS/Vi mIiIcIi are documented In the NOS/¥i iRS« 

I Among options of parasietersf there i»ay be Inconsistencies froii product to 
product* Such Inconsistencies Mill be renowed In tine future by daps against 
the SIS and code changes? or noted as exceptions ^ see Item 5 of section l»Z»^ 
btloiii* At this tlae^ It Is wore li«port«nt to document existing usages In 
order to*sake the SIS complete tlian It Is to renote Inconsistencies and 
conflicting usages*) 

Interfaces In code that do not conforia to the SIS* either by coiiflilsslon or 
omission? should be fSRed* The project-defined priority of such 9SRs »ay not 
be less than serious? and the such PSRs will not be rejected by projects* 

1*2*3 GOALS 

The specific goals of the Systeai Interface Standard %tBi 

a* consistency m I thin and across the system* 

fo« Human engineered for user* 

c* Achievable within CYBER 180 tliaeframe* 

d. Good perforirance* 

e* External Interfaces like CY170 Mhere this does not 
conflict Mith a? b> c and d above* 

There must be more than trivial gain In aspects of l^unan 
engineering to cause deviation from CY170 external 
Interfaces* 

1*2*4 REVIEWING AHD UPDATING THIS DOCUMENT 

The C180 SIS hBs been through a number of reyi&m cycles and has been 
forrRally approved by the C180 Baseline Change Control Board CBCCBI* 
It Is thus considered fairly solid* 

However? It Is recosnized that the SIS Is a living document ulth e 
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1«0 SENERAi 

1,2«4 R£VIEMINO AHO UPDATING THIS DOCy^ENT 

cof^tlnuai need for up4%tln§» f lease folloit the f^lioMlng Uut^eHnns 

\n reviewing and updating this docyments 

I* Limit comments or updates to «iysstlon of lnaccyracy# lack of 
completeness^ or necessary technical change* Avoid <iuestlons 
of personal preference. 

2* For r«4;atltely minor problems or questions resylting fro« a 

norinal revlenj a nora^ai DCS coament Is appropriate* It Is tl^e 
responsibility of tlie appropriate aytlsoris) to resolve tlie coia^ent. 

3* For more major updates tiiat may be so«eiihat controversial^ a 
stand-alone OAP Is appropriate* Tills allOMS a thorough retleii 
of the Issues Involved, yhen approved^ the DAP will be 
Included In the next SIS update. The Sis referee or editor 
should be Informed of any plans to submit such a DAP and the 
DAP should be In the fori of a proposed SIS update* 

4* There iilll fee occassional ••minor rev I eit cycles** of the SIS to 
Incorporate minor changes and previously mPri>v^4 DAFs. 
Authors may make minor changes to their sections at this time 

for r^vi^^ and approval* 

S« If conflicts enlist betneen tic products that cannot he resolved or 
change Is Impractical* the exception ulll be documented In the SIS* 

The nuiber of exceptions Is expected to be very small. 
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2.0 inPUl 



2,0 iii£yi 



This section describes tht standard and conirentlofis for 
Inpyt to products* Inpyt standard Is defined for Sjfsten 
Cowwand ianiuage* Control Stateinent^ source fH# 
organization and contents* 



2.1 SXSI£a.C0i3Mil}-UI^£yM£ 



Tme Sfstefs Co^iiiand Langyage is ttie set of fangyage rules 
and conventions to be folloKed bf an^ software product 
tliat presents a user interface imMth is not defined by an 
Industry standard). It Is docuaiented In tlie NQS/VE fiS 
(DCS docyicents MH36C9f ARH3610I. For eKamp I e, cowhands 
to call products* and operator coeiwands nlli coi>for« to 
this iangyane definition* It Is a requirement that ail 
products use tt^e standard cois^and language routines to 
process system cofRniand langyage statements CsucI) as 
product call cowiaands or product directives! • The Intent 
here Is that products do not duplicate code or functions 
already provided by standard cofflisand language routines. 
See HOS/Vi €RS CARH361G) for a description of tliese 
routines* 



2*2 EEQi2y£I-£iiL«£fiil3iiiM 



This standard specifies the parameters ithlch can be usb4 
in coBs^ands that call CY3ER 180 products* The syntax of 
the coflifliand Is docuniented In tiie NOS/Vf £RS* 



2.2.1 APPLICABILITY 



This section specifies ail parameter namesj descriptions 
and defaults of parameters on a command that calls a 
product. Requirements for use of the parameters ares 

• If a product offers a capability nl^lch Is the sa^e as 
one defined In this standards then the specification 
In this standard must be used* 

« A product is not perniltted to use a parameter defined 
by the standard for a purpose other than that 
specified by the standard* 

. A product need not Implement all the parameters or all 
the parts of a parameter in this standard. 

HeM parameter names or options must first be approved 
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as additions to this standard!* 

If a prisdyct provides a function descriii«d bf a p«ra»tt#r 
In tills stai^dardy tha descr il^ed para^attr nana and Its 
standard atlases nyst be sypported b^ the product as a 
minliyrs* 

ALIASES 

A, Standard atlases are made yp of the first letters of the 
parameter natse* All produtits utilofi yse tlie parameter 
ifsy st s y p po r t tli e s tan d ar d all as es * 

8« Aliases uhicU do not conforw to tlie first letter ryle# 
bkit Nlilch have Midespead ysage^ can be standard aliases 
oni¥ If expiicltiy docymented as suoti In section 2«2«4*3 
Cfaraaieter Nauies and OesorlptlonsI of tlie SIS* 

C* Non-standard aliases are tliose aliases mIiIo^ do not 

conform to the first-letter ryle* byt nhieli are ysed for 
cowpatifell Ity i«lth older versions of a NOS/VE prodyct* 
Nil* prodycts shoyld not sypport non-standard aliases* 
Older prodycts roay aiant to phase out their non-standard 
a I lases* 

D. 170 compatible aliases are those aliases uhlch do not 
conform to the first-letter ryle> byt uhlch &re ysed for 
cofflpatlblllty i«lth a 170 prodyct* Prodycts uhlch are 
not re<|ylred to be cotspatlble i^lth a 170 prodyct shoyld 
not ys e t h as e a 1 1 ase s • 

Some gyldelines for proposing new parafseter nats^s and/or 
options ares 

1* Use a new option of an existing parameter rather than 
a neM parameter name If the capability Is an extension 
of an already defined parameter (example: yse 0>0S 
instead of Inventing a nen parameter OS for debyg 
statements* 

2* For related parameters* yse aliases that emphasize tlie 
relationship lexample^ LO to relate listing options to 
the list flle» D* 
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2.0 m?m 

2.2.2 TERHIHCiOSY 



2.2.2 TERHiNQiOSY 

Dafaylt* Ike vslut ysed for a partfisttsr ubtn th^ parteeter 
does not apptar in a cowhand. Section 4.3 on installation 
parametars Indicates nhicli paranseter dafayits are 
iDstailatlon o^ianseal^ie. Tlie defaults specified In 
section 2«2.4.2 are tliose gxpected to be fnost often us&d* 

Z*Z*3 SYNTAX 

The syntax of ttie coainiand Is defined In the NCS/VE ERS. 

If a parameter Is omitted# default values are used* Use 
of <paraffieter n«»e « Q¥¥> results in turning off m singiB 
option psran^eter or li^ooiean single specified yaly# 
parameter* Use of <para»ieter naiBt> * HOHB indicates that 
a specified value Is not supplied for a ffiultlpl^ value or 
Jiultlpie option pararseter (for example* IQ - NOH£ causes 
none of the list options to be selected). 

When the parameter value Is a file naroet the file na^c 
$Nyil should be used to negate that file (for exaapiey 
B=$NUiL causes the product not to ptq^u^b a binary object 
code file). $NUIL Is a reserved file naise* A read ulil 
respond iilth an end-of-lnfor»atlon. SNUiL Is an infinite 
sink for writes. 

Tfae follonlng algorithm Is applied to paraiseterss 

1. Initial lyf all value options for tl^ls parameter are 
considered deselected fi.e. there are no initial 
values) • 

2. Only the option<s) specified In the value list art 
then selected. 

The <na^e> used on the cotai^and to call a product can be 
either an alias or a long form as follows: 

Alias Long Forw Description 

API a prograssiilng language 

BASIC beginner's all-purpose symbolic 

Instruction code 

CC The language C 

COBOL common business oriented language 
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CYBIi Cyber Ifiipie^entation lan§uagt 

mif iOIT^FIlE Edit SCfftn Cfor raw text J 

EOIi EDIT.ilBRARY idit Screen Ifor Soyrce Cede 

ytllJty ilt^rariesl 

FH U f n e HI an a sefflen t ut M i t y 

FTN FORTRAN f or^yJ a translation 

LISP list processor 

H4P Hatrix Algorlthw Processor 

MERSf raerge 

PASCAL Pascal 

PROiQS Programiing In Logic 

PLI prograncning langyade I 

OU ^yery update 

SCO source code utility 

SORT sort 

VX UNIX systtffi epulator 

2.2.4 PARAMETER 

Qcscyrrence of any parameter wore ttian once in a control 
stateflient Is an error* 

Product set meniters providing the I# B* and L paraieeters 
a;yst support t^e followlny positional ordering on a 
non-keyKord call. There Is no guaranteed cossison ordering 
of other parameters to a product set member except nhat 
11^1 ght be docuipented In the reference manual for that 
product. 

1. INPUT 

2« BINARY Cnorma^iy the main desired output of a compiler) 
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2.0 IHPUT 

2*2«4«1 Positional Or<Serlf^g of Pro<3«ct Set Pm&mtters 



3. LIST 

See the Comraend Interface CPart I) of tti« HOS/Vi ERS for a 
description of the file reference* uhlch Is the s^ntai to 
he ysed for specifying a file name as a paraipetar valye* 
If no position Is sped fi€d# the prodyct miH reposition 
the file before use as foUlons^ 

a) for a file naieed SIHPUT^ no repositioning will 
take place If the file Is at beginning of 
Information* at end of Information* or at a 
partition bounoar^* Otherwise* It mIII be 
repositioned to end of partition before usa« 

b) for a file naroed SOUTPUT* the prodyct mIII do no 
repositioning befi^ra ys«» 

c) for all other files* the prodycts mI i I reposition 
to beginning of Inforisation before use* 

Exa»!ple5 If a call tc SCU has hnen wade to write tiree 
source decks to COHPIiE Cthe first FTH* the second CY8IL* 
the third FTNI and they ere to be coispiled ulth the object 
code pieced on file LGO* the $ASIS positioning ®yst be 
specified on ttie secono and third compilations since 
def ay it positioning Is rewind. 

FTH I=CCHPILE 

CYBIL I=CCHPIlE.$AS£S*B*LGO.$iiSIS*L=$CyTPyT 

FTN I=C0MPIl£.$ASIS*S«lG0.$ASI3*i=$CUTPUT 

There are foyr l<inds of paraweterss 

(1) Single Specified Valye 

This is a paraipeter for nl^lch the yser myst specify a 
valye* sych as a file reference or a boolean as In the 

f r Jl! 3 

Keyword » <boolean> 

Mherss 

<booiean> s: = <trye> I <false> 

<trye> ss = TRUE I YES I ON 

<falS€> ss * fAlSE ! NO I 0F# 
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2.0 imm 

2*2«4»2 Tjfpes of parameters 



For the sake of consistencf tlie ytlyes ON and OFf niil be 
used in tills docufnent* Products mai olioose any of tlit 
yilues for <tru€> and <false> desired and des cr Ibe ttit 
cl^oJces as sucti in tNe product docy»entatlon« Ths 
operating s^st€» kI 1 1 accept tlie values for <true> and for 
<false> e^iu Ivaltntf y litien the standard Copland laniuaie 
routines for ti^e controi stateinent processing are us^4m 
hs a resyltj users ulli bm able to enter any of the vtlyes 
for <trye> or for <filse> ultliout regard for >ihat values a 
product lias cl^osen to document. 

iZ) Multiple Specified Value 

Tills Is a parameter for yhicti nore tlian one value (sucti as 
file references! aay be specified. The foria 
<pararo€ter-naw€ « HONE> niil be used to Indicate that none 
of tlie available options for a parameter are <lBs^r%4m 

13) Sins It Option 

This Is a pBr^met%r for nfilch ttie user specifies 

<optlon> « ON 

C4 ) Multlpl e Option 

This Is a para»eter for which the mt&f way specify the 
names of aiore than one option. 

For inuitlple specified value paraneters the value list 
syntax is as described in the N05 180 £RS^ Part I section 
**Parafneter lists and Types**. A value list consists of a 
series of value sets separated by one or more spaces or by 
a single comma. When more than one value set Is 
specified^ the list ir*ust be enclosed In parentheses. A 
value set consists of a series of values separated by one 
or more spaces or by a single com^a* ytien more than one 
value Is specified the set mast be enclosed In 
parentheses. The rule is that an outermost pair of 
parentheses belong to a value list and Inner pairs of 
parentheses belong to value set. 

The for«i <paraffieter name = NONE> Kill be used to indicate 
that none of available options for a parameter are desired. 
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2,0 INPUT 

2.2.4.3 Paraaitter Nstaes and Descriptions 



2 • 2 « 4 • 3 t3L%mMtStJ^M&&M^MMJkSLS£glB%lQ,UM 

Th€ parameters sr« described In alpliabetlcat QrdMr* 
P ar Bm et er S t a n d a r d 

Nawa Alias Parameter DascrlPtlon 

AUDIT A AUD Is a non-standard alias for AUDIT. 

Tfels pMf mister Is us%4 to indicate tliat 
tfee pro dye t Is feeing rwn for a yd It 
testing. The patametBT oayses tlie 
selection of any other parameters nil Ich 
m&w be nQB4&4 for aydlt testing as nell 
as selecting the inethod of processings 
wfelch lay differ fro^ norwal processing. 
For exaepltj In COBOL the list of fteass 
might inclyde the mode Mhere dlsptsys of 
ny«erlc Items Mould not fee edited. 

Single option parameter. Oefayit* the 
option Is not selected* 

AUDIT - ON selects this option. 

Blf^ARY 8 8iHARy.08J€CT and 80 are non-standard aliases 

for BINARY. 

Binary Ol^Ject code oytpyt file. 

This parameter specifies the file to 
contain the object code or text produced 
by a compiler or assembler. 

B * <f i I e> 

B'SNULl Indicates t^at no sych blntiry 
object code oytpyt file is to be written* 

Single specified walye parameterf 

defaylt = StOCAl.tCQ 

If a list of flies is specified for INPUT* 

then all the binary oytpyts accymylate on the 

specified BINARY file. 

COilATING^SEQUENCE^X CSA SEQY la a 170 compatibility alias. 

CSN Collating seqyence <X - Name# Step* 
CSR Remainder* or Alterj end Y«N> S* Rt or AK 
CSS The parameters S£QN, SEQS# SEQR and SEOA 
control definitions of collating 
sequences for an applicable prodyct. 
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2.2.4*3 Paraiettr Niwes and Descriptions 



CSN* Tine CSH paraiseter signals tt^t 
start of a collating sti|yeiic« 
definition* Tfe€ definition of ona 
collating se^yenct continues with CSS# 
CSR^ CSA paramatarSf It is tersiinated 
by any puraroetar not one CSS# CSR> 
CSA. Tlie fofiR iss 

CSN - <naj«e># wtitre naaie is the na^a of 
tlie coltatlng se<iyance« 

CSS. Eacli CSS paraaieter specifies 
either a singie step or a rangd of 
steps. The for* Iss 

CSS * <va«ye-llst># nhere the 
expressions in t^e valye list are 
ciiaracter expressions* 

CSR. This paraai«tar specifies all 
characters In the character set not 
specified In a CSR ptraiaeter# explicitly 
or inspllcltly. The for« is* 

CSR = ON 

CSA. This parameter «ay fee specified to 
aiter all e^yated characters In oytpyt 
records so they feecoffle the first 
character in the appropriate CSn 
par aiiieter. The form iss 



CSA = ON. 

COHPILE C Compile file. 

This paraaieter specifies the oytpyt file 

on Mhlch compiler soyrce statef»ents are 

written. Examples are« the oytpyt 

produced by a conversion aid ytllltyi the 

ypdated soyrce oytpyt fey the soyrce 
maintenance ytllity for inpyt to an 
assen^hler or compiier. 

Single specified valye parameter^ 
defaylt = COMPILE. 

COHPILATION. CO If selected* compilation directives Isee 
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2.0 INPUT 

2*2.4.3 Far amct «r N im «s ar^ <i 0«s cr I p 1 1 ens 



DIRECTIVES SIS section 2.4) till I be recmnizt4* 

Otl^efMise GompHMtHn directives nlH not 
fee recognized — If dlrectiwes are expressed 
as a special fofP of conisent they iilli be 
treated as are ail other comments. 

Sinsie option parameter* Defayit » ONf 
directives are recognized. 

C170.C0HPATI8LE CC If selected* all possible CYBER 17C to 

CYBER IBO prodyct differences nlll be 
converted to the CYISO version or 
diagnosed Ml th messages. For exaapltj In 
C080i ItQms specified as C0Hi»-4 ulli be 
assyeed to be COHF. All prodycts uhlch 
sypport this paraneter must provide a list 
of sycti conversions or assyfflptlons in their 
manyals* 

Single option parameter. Oefaylts the 
option Is not selected. 

C17C_C0HI>ATI8LE « 01^ selects the option* 

DEBUO^AIDS OA Oebygglng aids. 

This paranieter specifies the debyg options 
to be selected* All prodycts neeil not 
sypport all options. Hyltlple options «iay 
be specified. The defined options are: 

ALL All of the available options ^re selected 

for the DE8U€_AIDS paraaseter* 

OS Oebygging statements. All debygglng 
stateinents nil I be compiled* A 
debygging statement Is e stateient In 
the source uhlch is ignored by the 
p r dy c t yn I ess this opt I on Is 
specified. Debygging statendiits 
ysyaily specify debyg actions for the 
modyle containing them. See also 
section 2*4*7 of this standard* 

OT DEBUG TABLES* Generate line nymber 
and symbol tables as part of the 
object code* 

OC Object code regardless* Prodyce 

object code* regardless of etfors In 
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DEI=AyLT.COlLATIGN 



the soyrca a«d saver itf of sycfe 
ar r ors * Fo r camp i I a rs» exacy t Ion of a 
fii^a contalf^lng a fatal error slioyld 
result In a call to an object tine 
routine utiicl^ mIII terminate ttie 
exacytlon uith a fflassage* (See 
section 3.4 for error statys retwned.l 
Prodycts Mltb no oiiject tlsga Mbranr 
fflay generate a zero (progran error! 
Instrycton for lines In error • 

PC Paraiieter cfiecklns* Generate psraweter 
checking Inforisation as part of the 
object code4 If PC Is specJfledj 
any compiler mIiIc^ sypports paraneter 
checking mHI generate actyal and 
formal parameter dscrlption 
Information In the object code to 
enable I oad-tlpe detection of 
parameter mlsmatclies* 

TR Flow tracing* Activate trail pr agmats 
In tlie source program. Unless TR Is 
specif I edf trace prtgmats liave no 
effect* 



Hyltlple option parameter. 



The defaylt Is 



DC TbIs parameter specifies the Melgilt table 

to be used for the evaluation of cliaracter 
(string) relational expressions and to be 
used by Intrinsic fynctlons Mhich Are 
collated sequence dependent {for example 
CHAR and I CHAR In FQRTRAM), The defined 
options are: 

U or USER 

A user specified weight table is 
used* In FORTRAN a collection of user 
call ab i e pr oce dy r es Is pr o ¥ I ded f o r 
manipulating the usbt weight table* 

F or FIXED 

A fixed (ynmodlf labi a) processor 
specified welgt^t table Is us^iim 

Single specified vaiye parameterj 
defaylt = FIXED. 
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2,0 IH^UJ 

2*2. 4,3 Para^etar N«iii«s and Descriptions 



OIRECTIV€S.F UE 



Of 



€RROR 



ERRGR.tfVEL 



£L 



DIRECTIVES Is a non-standard alias. 

OIR is a non-standifd and a 170 coiipatibis atlas* 

Additional paramttafs nl li 1st raad from 
this fH« aftsr all of ttsa control 
stateffiant paraniaters t^ave been r€ad« 



DF«f I la-naaie 
Par aai^ter s 
f I le-naflie. 



will be read froia file 



DF*if He~nafflel£#f Ile-naae21 • . *) 
Parameters mHI be read from tie 
flies In tiie order tliat tbey are 
named* 

Multiple specified ¥alye paranet«r# 
defaylt « HO ADOITIOMAL fARAHETERS ARE 
READ* 

Ertor file* 



Tills par amet 
fl Je to race 
Information* 
Cof El sped 
diagnostic I 
Is tilghly re 
required) tli 
offending so 
f 1 1 e In conj 
If ttiere Is 
par asseter) t 
are also iirl 
file n awe f 
tt^e f I le nam 
error line a 
ti^l ce. 



Single specified valye parameterj^ 
default « SERRQRS 

Error Level* 

This option Indicates tlie severity level 
cf diagnostics to be printed on th9 
user*s listing* The levels are ordered 
by increasing severity* Specification of 



er specifies 


the name of the 


Ive error Us 


ting 


In the even 


t of an error 


fled severity 


or hi glier ) the 


s written to 


the E file* It 


cofflsended Cth 


oygh not 


at a prodyct 


also oytpyt the 


urea 1 Ine or 


lines to the E 


ynctlon with 


the dl agnostic* 


a listing fll 
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he error line 


and diagnostic 


tten to the L 


file. If the 


the i file 1 


s the saoie ns 


e of the L file# then tiie 


nd diagnostic 


are not nrltten 
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a particular level s#lects that level and 
ail more severe levels* Prodycts mIII be 
alloiied soflie fitxi&lllty In specifying 
the kinds cf diagnostics that fall In 
each of the four categories: InforiRatlonalj 
Marnlngf fatal » end catastrophic* Tlie 
follovting descriptions are provided ts a guide* 
The levels In Increasing order of severity ares 

I Informational* This Is an Infornatlonai 
message m^ed to flag a siisplcloys usage* 
The syntax Is correct but the usage Is 
oyestlonabi e* for 170 coiipatilsliity oniy# 
products are free to use «T« in addition to 
•I** <Hoifeverjlf only one Is used* It »ust 
be I»> Output «ust always be *I*# never *T« 

y yarning* This Is a diagnostic Miere 
the syntax Is Incorrect but the 
product has ^ade an assusipt Ion {such 
as adding a cofliAa) and continued* 
Messages Indicating attempts at error 
recovery are at this level* 
Diagnostics of M level should be 
errors that the ustr can avoid by 
pr ograifl isodlf I cation* 

f Fatal* This Is a diagnostic uhlch 
prevents the product froi« processing 
the stateflsent In Mhlch It occurs* 
Unresolvabie semantic errors also 
fall Into this class. Such errors 
may not relate to a specific 
statement In the program unit* 
Errors of type 'ERROR* will be 
treated as e^ulv^lent to 'FATAL** 

C Catastrophic* This class of error Is 
fatal to continued processing* The 
product Is unable to continue Kork on 
the current program unit* Honever* 
It should still advance to the end of 
the current prograat unit and atttispt 
to process a subse<iuent unit lif the 
product specif icaton alloMs multiple 
program units In a compilation}* 

Single specif I eo value parameter* 
default - M. 
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ESTIHATEO^NUHBER, 
RECORDS 



£HR 



EXCEPTION. 

RECORDS. 

MIE 



ERF 



EXPRESSION. 
EVALUATION 



£E 



£l = NGHE cayses no mfors to Ise llstei* 

Estlinated Numfeer of R«cords« 
Tt^is paramater specifies tlie estlnatad 
number of records to l^e processed is^ a 
product* For extapief SORT cari ys« It to 
cayse selection of efficient i#des of 
process I US* 

Siiifie si^aclfied vaiye ptraiietar^ 
default = 80000/IIRi. 

Tills Is a f I le containing exception 
inforipatlon* rrodycts mIII be aliened 
flexibility In defining its contents* 
For exafflpie* SORT HERGE *«lli use It for 
out-of-oriar laerge inpyt records* 



Single $peclfie<l yalye parasieterj 
Is product dependent* 



defeyit 



The options of tills paraiReter control the 
style of code generated for tfee 
evaluation of soyrce expressions* Note 
that ttie processing controlled by this 
parameter Is separate from that 
controlled by the optlislzatlon level 
parameter^ but isay affect the extent to 
liliich opti nidation Is possible* The 
defined options are: 

C or canonical 

The code generated to evalyate an 
expression nil I islrror the expression 
Interpretation ryles as defined In 
the product specification* For 
FORTRAN this Moyld be section 6 of 
the AHSI standard* This option also 
serves to Inhibit the CCG ••reiroyp" 
option* 

HE or lualntaln.exceptlons 

Inhibit code optlnslzatlons Mhlch 
eliminate Instructions that sight 
cause hardware exceptions at 
execution time* This option also 
serves to Inhibit the CCG 
"ynsafe.to.safe" option* 
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£XT€RHAL. INPUT 



FASTIO 



PORCEO.SAVE 



HP QT fflaintaln«f>r«clsli3ii 

Iniiibit cade optimizations mhloh 
cliange a floating point operation to 
a ne«i form tiiat Is ^at^eiRatlcaliy 
e<iu]valent but not compytational ly 
eiiui¥a]ent« This option also %%rwBS 
to select the CC€ "ealntaln. 
precision** option. 

R or reference 

Intrinsic functions l€«9. ttiose 
<3eflned In C*IML) for whlcii a 
procedyre ceil is generated will be 
called by reference rattier than by 
V a I ye • 



Multiple option parameter* 
Oefaylt = HONE^ none of tin 
selected* 



opt I on s is 



£1 ex^IHPUT is a non-standard alias* 

Tills file is for yse by products Mlilcii 
provide ttie capability of temporarliy or 
alternately obtaining source statenents 
froi a file external to tbe Input file* 
For example* the COBOL COPY state«ent# 

Single specified iralue parameters 
default =* $NULt. 

Tbis parameter can be used only by SGRT/HIRGE* 
This paraiseter Is on the predecessor products 
SORT 5 on the CYBEi 17C, and Is for cowpatlbl I Ity 
only* This paran^eter has no effects nil! go aiiay 
at a later release* and till I not be described 
in the reference nanyal* 

FS If selected, the definition status* of 

all entitles iilthin a subprocedure of a 
prograiR will be retained upon exit frosn 
that subprocedure. Effectively this 
dlsallo)«s placing any yarlables on the stack* 

Single option p8r«fli«t«r. Default « OFF* 
definition status need not be retained 
except Inhere so re<iulred by the product 
specification* 
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f=ROM 



INPUT 



Old file* 

Tfels paraieter sptclfles the data Input 
file for the proiiuct. For examples tt?e 
file ffon Mhich a co^w ytlllty reads* 

Multiple specified iralije paraieteri 
default « OLD. 

Input file. 

Tl^ls parameter specifies the source Input 
file name to the product* Mhere reasonable^ 
a list of fJle names Is al lowed* 

Multiple specified value paraiseteri 

default ^ SIHPUT. 



INSTRUCTION. 
SCHEDULING 



IS 



INTERACTIVE, 
INTCRFACE 



II 



This parameter specifies whether or not 
instruction scheduling mIII be performed* 

Single option boolean para^eteri 



YES This option selects 

default = NQ 

omitted Is same as NO 



the parameter* 



This pMrrnittBT detersilnes whether the product 
Kill Initiate interactive processing Mltt$ the 
user;^ Instead of operating In Its usmzi batch* 
oriented fashion* This consists of displays 
written by the product to file $QUTPlJTj and 
user-supplied answers from the file IINPUT* 
The Interactive interface can be invoiced 
either froai an Interactive ter^lnal^ 
or a batch Job* 

Single option boolean paraiseter: 

YES This choice Initiates the Interactive Interface* 
The processing of all other parameters on the 
command line Is Product dependent <see the 
appropriate product }nanuai)# except that the 
STATUS parameter Is never Ignored* The product 
}nay# but Is not required to* allow the user 
to decide Interactively whether or not the 
other parameters on the coisisand line are to be 
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NO 00 not Invoke tfee Intertctlvs lfiterfa€«* 

omitted Saisa as NO* 

KEY K Key fleldCs). 

This peramater sp«€lfl«s the kay flei<ls 
tfitt determine ttie manner In mhich fapyt 
data Slight b% processed lif a prodyct* 
For exa^ple^ SORT mI 1 1 yse tfee parameter 
to determine the order TBcor^s mill be 
sorted* 

KEY«<yalye-Hst> t 

I 
The format of the KEY parameter Is 1 

prodyot dependent* I 

tEAOiHG^BLAHK.ZERC LB2 If selected* leading blanks in nyaerlc 

fields are treated as ^eros in arithmetlo 
statepents and oo«ipar Isons* If not 
s e I ec t edj ny mar i c f I e 1 4s th a t con tain 
feianks are In error* 

Single option parameter* Oefayft* tise 
option Is not seieoted* 

IBI * ON selects the option* 

LIST L Listing fi le. 

This parameter specifies the file where 
the prodyct writes the soyroe listing^ 
diagnostics^ statist I cs> and any 
additional list Information (see LO 
parameter) • 

Single specified #alye parameter^ 
defaylt =$LIST* 

If a list of files is specified for inpyt# 
then all of the list oytpyts accymyl ate on 
the specified LIST file* 

LIST^OPTIONS LO Listing options* 



The options of this parameter specify 
Mhat extra information nil! appear on the 
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listing file <LIST i»arawet8r). Hyitlple 

options ftiay fee specified* The defined 
options ares 

A Attributes. A listing of tlie 

attributes of eacfi entity defined 
Ml till n tlie proara«B is produced* If 
R itas seltctedf the references mm 
shOKn on tlie same listing. See 
section 3.3.5 for Jiore Inforffittlon 
on attributes* 

8 Profilbit Banner. TJ^e banner Is not 

sent to the Listing file. 

80 Bfte Offset* (Release 2 reaturel 
If source statements are llstedf an 
offset field Is Included (see 
section 3.3«3«3}« Tills option Is 
ineaiilngful only for Mide format 
1 1 stings. 

0€ D€TAII£0 EXCEPTIGHS. Print out 

exception file isessages as often as 
a record Is smt to ttie exception 
file. 

H HBPm A storage layout ssap for 

coffiiiiion blocks and e^suliralence groups. 

WS Herge Statistics. Turn on listing 
of yerge statistics* 

G Object code listing. A listing of 

tlie generated object code mith 
instruction mnemonics* 

P Prohibit protupt. The norreal Input 

prompts are not sent to the Listing 
file. 

R Cross reference listing. A cross 
reference of program entitles 
shoeing locations of definition and 
use within the program. 

RA Cross reference listing of ail 

program entitles whether referenced 
or not* 
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RS Record Statistics, list the 
statistics for tl^e records 
sorted/iiseriied* 

S Source • Soyrce listing of tlie 

program* 

SA Source llstioi of all source 

statements Inclyding lines turned 
off bw a source enljedded NOLI ST 
directive. CSee section 2*4*2) 

Multiple option par aiaeter* default * S. 

to » NONE causes none of tlie list options 
to be selected* 

LITfRAL^CHARACTER iC Tl^ls parameter can be used to ctianse tlie 

ctiaracter that de lira Its non— numeric 
literals^ Default literal character Is 
<luotatlon mark* 

LC-OFf is an error. 

l0AD.C0LLATIf^€_TA8LE iCT This paraiaeter loads an eicternaliitiglit table 

and associates It ultti a collating 5e<iuence nana* 
The format of tlie table Is AHTSCOilATE.TABlE. 

LCT=(COLLATIHG_S£QiJ£HCE.NAH£, yEISHT.TA8lE.HAHE) 

DEFAUlT«no we I gilt table Is loaded* 

MACHlNE.DEl^ENOENT HO This parameter specifies *«hether use of 

machine dependent source features Is to 
be diagnosed and If so# hoM severely* The 
severity level Is one of the foil oiling: 

I or informational 
y or warning 
f or fatal 

Errors of type 'ERROR* wlil be treated as 
equivalent to •FATAL*. 

Single si^eclfled walue parameter* 
Default - I^QNE# nsachine dependencies are 
not to be diagnosed. 
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MAS3«ST0RAGE^LIMIT HSi 



QHIT.DUFIICATES 



CD 



ONE. TR I?. DO 



OPTIHIZATIOH. 
ISVEL 



GTO 



Qi 



mss storage Llelt* Tills parmeter 
specifies tiie liiaxlssyfii nunlder of 
cliaracters ttiat i^ay fBskfim on mass 
storage dyrlr^g execution of th# product 
(for eiawple* SORT)* 

HSi^expr* The nnsifoer of cliaracters 
Indicated by expr Is tfie sass storage 
tiflilt* BiLpr must bm an Integer* 

Tills Parameter controls o»ittlng ai Ijyt one of 
tiie records i«hlcli t^awe e^ual key values* 

00*0N Oralt all Isut one of ttoe records *(ilth 

ei|yal values* 

Oo=OFF Do not oilt dypllcate recor^is* 

DEFAULT « OFF 

T^ls parameter selects tlie ^Inlmya trip 
count for FORTRAM 00-1 oops to be one 
rather than zero* 

GPTIHIZATIQN and OPT are non-standard aliases* 

This paranieter specifies the level of 
object code optimization* All prodycts 
j\&b4 not support all defined levels* 
Ho i« ever If product supports a defined 
levels It must be selected by the 
specified option naise* Ideally all 
products Mhich support this paraneter 
should recognize ail defined 
options and Issue Informative diagnostics 
for unsupported options that the user 
selects* Ailonable options are: 

DEBUG Object code Is stylized to 

facilitate debugging* Stylized 
code contains a separate packet 
of Instructions for each 
executable source stateisent^ 
carries no variable values 
across statement boundaries In 
registers^ notifies OEBUG each 
time a beginning of statement or 
procedure Is reached^ etc* 
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LOW Lowest level of prcdyctlon 

«iyallt^ cede* Cede Is not 
completely stylized* 

HISH Hiih level of productlon^yality 

code* 

Single specified walue paranieteri 
def aylt = LOy 

OUTPUT Q This paraweter specifies t*^e file Khere an 

lnteractl¥t product writes Its oytpyt» 

Single specified walye parameter^ 
defaylt « SOOTPUT* 

QMNCOD£.FIX£0« OFi OMNFL Is a 170 cowpatlile alias. 

LENGTH This ptramater specifies the record length 

In characters of all records that wl IS be 
Inpyt to a product frois any OMncode 
procedyre* See also OHRL and Wn parameters* 

OFL * <lntager>» ivery record supplied 
by an ouncode procedyre nlll contain 
exactly <lnteger> characters. Oefaults 
tSee OHRL). 

QWNCOOt.HAXmyfl. OHRL OWHMRL Is a 170 co«patlblllty alias. 

R€C0R0«LEN6TH The minimum length In characters of any 

record syppi led by any ouncode procedure 
Is specified by this parameter. This 
parameter may not be specified if the 
prodyct has Input or outpyt fl^es and If 
any of their associated HRL*s are at 
least as large as this MRL* See also OPn. 

OHRL * <lnteger>. There til 1 1 be at 
«!ost <lnteier> characters In any records 
supplied by an OMncode procedure. 

Default.- If OFL and o«RL are both 
omitted^ the record length specification 
nl 1 1 depend on the length specifications 
of tt^e Input and output files. If all 
Input and output files have fixed- length 
records of the s^me length that length 
Mill serve as ttie default for OFL* 
otherwise the largest HRL or Fi from any 
Input or output file will setwm as the 
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def ay| t for QfIRi* 

QMHCODE.PROCEOURE.fl QPn QMUn is m 170 c<sfflpati fel I ity alias. 

Owncoda procadura n <rs « 1# 2* 3^ 4# 5f 
• «•«)• Ttia paxl^ys of n Is laft to tia 
Individual product* Bmnci^4B procadyras 
sra ysar written routines that »ay ba 
ioadad liltti ttia prodyct and axaoytad at 
specified points dyring product 
execution. Sea ottier oyNCQOf 
parameters for wore Information on this 
capability* 

The Procedure specified by this 
parameter nl II be executed at a 
specified point n during product 
executloii* 

QPn * proc.naae* The procedure 
pr oc.naffl€ mI 11 be executed at i 
specified po Int n* 

Oefauits No procedure mIII be executed* 

RESyLT^ARRAY RA RESA Is a non-standard alias* This para^ieter Is 

used to return all or part of the result array* 

RA*array^naroe# nn SCL array 

Defaults Do not return af^y Information froia the 
result array. 

RETAIN.ORGINAL. ROQ RETAIN and RET are non-standard and 170 

ORDER compatibility aliases* 

£<iuiya3ent records or records Mith 
equivalent Identifying characteristics 
Mili be output In the same order as 
input by a product* For example^ nith 
SORTf the equivalent Identifying 
characteristics Mould be equal iceys* 
The order in Mhlch muitiple Input files 
are specified Is the order in i«hlch 
records mI th equivalent characteristics 
are retained Mith this parameter* 

ROO^CN* Records Mith equivalent 
characteristics mI 1 1 retain their 
original order* 



2-22 

CYBER im Swstem Interface Stmn4&r4 

Z.Q INPUT 

2*2*4.3 Paraiettr Ntmes anti Descriptions 



RGO=OFi=« Records i^ltl^ e^iylvaient 
characteristics will not necessarily 
retain tfteir original order* 
Defaults Sane as ROO«OFI=* 

RUNTIHE^CHHCKS RC This parameter controls ulilch ryntlme 

checks are coisplieiJ Into the object 
cotJe ani/or selected for r*intl«« 
library roytlDts* Ryntlise clieoks mtb 
prodyct dependent but If a prodyct 
sijpports one of the ones described 
here# It must be selected b^ the value 
specified* Defined values Mt^i 

ALL AM supported values are selected* 

f Files checking* Selects cliecking of 

Bftofs Involving file variables and 
buffer varlibies* 

N Pointer check I ng* Selects checking of 

fnlsuse of pointer variables* 

R Range checks* This option selects 

range checking for one or laore of 
the foiloning 

~ character substring expressions 
- scalar subrange assignments 
* case varl ables 

S Subscript checks* This option 

causes subscript and Index 
references to be checked to ensure 
that the> mtb « I thin program 
defined limits* 

T Tag field checks* Selecting this 

option ensures that accesses to 
variant records are consistent 
Mith the value of their tag field 
Clf one exists}* 

This is a fsultipie value parameter* 
Default is RC^NONE* 

SCR€EN.NAm€ SN The name Identifying an object screen 

definition to be retrieved fro® the 
user's object library* 
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SEQUgNCEO.ill^ES 



SI 



SESSION.TYPE 



ST 



SOURCE 



STANOAROS.DI AGNOSTICS SO 



Sln§le specified talye paraipter« 
Optional » no defaylt* 

This partmetar saMcts FORTRAN 
set^uancad mQ4% sourca line forsitt as 
described in section 3»2 of the fTN180 
£RS« Mote that this format Is 
Incoflipatihie with the st%n4^r4 SIS 
Csectlon 2»3*2) soyrce Hne foraat 
Mhlch alloMs tlie length and location of 
a line nyiiher to he specified in the 
source file attrlhytes» 

Single option paraajeter. Default « Qff^ 
soyrce lines conforni to the st%n4Mrii 
SIS fofjaat. 

One of the keyiiords €OiT# HELP, UTILITY, 
Used to present Initial SOF session 
environment. 

Single specified valyr parameter* 
Opt I one If no defaylt* 

SCU Inpyt. 

line Images of the generated prografli 
Mill bm Mrltten to this flle^ In a 
format acceptable as Inpyt to SCII* 
Each prograiii ynit on the S file kIII he 
preceded by an SCU directive i«h|€h 
Indicates the beginning of a nan source 
deck* 

Single specified parameter va|ye# 
default = $NUil. 



Standards diagnostics, 
applicable standard) • 



CANS I or other 



This parameter specifies whether use of 
non-standard Input source statements 
are tc be diagnosed and if so# how 
severely* There are t^io values 
defined* severity^ and nanse of 
standard. The severity Is one of the 
following: 
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I Inf orsjatlonal error* Staniitrds 

errors are treated as errors Kith 
this severity* 

¥ Standards errors result in narnins 

messages* 

F Fatal ^rwQf m Non-standard ysages 

resyft in a fatal error* 

Errors of type *£RRQR« Mill be 
treated is t<|y|yaient to «FATAL** 
The second yalyet name of standards is 
to be defined b^ tlie products as 
appropriate* If this parameter Is not 
specified* then non-standard eistensions 
to the prodyct are ailot4ed# in^t 
diagnosed as errors} m 

%D-HUH£ causes standards errors not to 

be diagnosed* 

Multiple specified value parameter^ 
default ' NONE. 

STATUS STATUS Status Variable* 

Ho all€s Is permitted for STATUS* 

All products are re<iulred to support 
this parameter* 

This parameter specifies the nase of 
the SCi status variable to be set by 
the product to Indicate the occurrence 
of error conditions* See sections 3*4 
and 4.4 for ^n account of the status 
variable* See also NOS/V£ ERS* 

Single specified value parameter* 

Errors of type 'ERROR* will be treated 
as equivalent to * FATAL** 

Default! None* 

See Error Pr ocesslnfl 

section 3*4 for a description of error 

processing that results from use of the 

default status variable* 
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SUH S Syw FlaldCsK. 

This parameter specifies ttiat ynlts cf 
Input data hating k^y fields e^yat Csee 
KEY parameter) m^w be comblfied li^to 
ittffis or ynlts lo a prodyct dependent 
inanner* 

Cfor eicaaiple* SORT Mill use the 
parameter to oomlilne all records* 
having Key fields e^ual> Into a single 
record* Each smm field In the nen 
record Is formed by syni^lng the vilyes 
In tlie corresponding fields of ali 
e<;yat records*) 

SUH*<valye-ilst> 

The vafya list will contein one or 
more yalue sets* Units of Inpyt 
data tilth e<iu€l Icey values nl 11 be 
combined Into neM ynlts or Iteais 
and fields specified by the ytlys 
sets Hill b€ summ€4f accord Ins to 
prodyct specifications ^n4 needs* 

Hyltlple specified valye parm^eter^ 
defayit = NO sm FIEiOS* 

SUBPROGRAM SP Is m non-standard alias* 

If this option Is selected^ the proiram 

is compiled as a sybprosraa; Instead of 

as a inain progrem* 

SyBPRGGRAM « 01^ selects the option. 

Default: the option Is not selected* 

TAPE^SCRATCH^fllES TSf Tape Scratch files* 

The tapes with the names specified by 
this parameter Mill be ysed by the 
prodyct to reduce tl^e disk space ysed* 
The tapes myst have already been 
retsyested prior to execytlon* The form 
I s: 

TSF*(f II e.name jflle.nane *•*) 

Defayit: Tape scratch files Mill not 

be ysed* 
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TJ^RGET^HAIHFRAHE TH This parameter specifies tfie raactilne for wlilch 

code Is to be generated* The defaylt# if no 
option Is selected^ Is tlie naclilne on uliloli 
coppllatlon Is P€rfi^rme4m 

CieOMI or C18O.MQO£l.IN0£PfND£HT 

The code generated nil I ryn on any 
Cfber 180 model* 

C180V or C180«ViCT0R 

The code generated nil I ryn on any 
Cyber 180 isodel that has tec tor 
Instructions* 

defaylt = oailtted 

TiRHIHATION^ERRQR^ TEL This parameter specifies the 8i|nla5«« 

LEVEL diagnostic severity level which kHI 

cayse a prodyct to return an abnormal 
STATUS ypon cosipletlon of processing* 
A nora^al statys Is retyrned otherMlse* 
The severity level Is one of the 
f ol lonlng: 

I or lnfor«ttional 

VI or Marnlng 

F or fatal 

C or catastrophic 

For 170 compatibility only^ pro dye ts are 

free to yse «T* in addition to *I^ (honever* 

If onl^ one Is usedf It ffiyst be *!*}• 

Output iiill aluays yse 'I'l 

not *T«* Errors of type 'ERROR* nil I 

be treated as equivalent to *fATAL** 

Single specified value paraneter# 
default « F. 

TEXT.NAME TN NaiRes of texts to be r^ad from the 

files or libraries specified by the 
TEXT.RESIDENCE parameter* The total 
number of values alloiied Is product 
dependent* Products that have a text 
name directive may choose to support 
the TEXT^RESIDiNCE but not the 
TEXT.NAME parapeter* A fatal error 
occurs If any of the texts specified Is 
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not foynd* 



Huttipie specified valye pari8iettr> 
defayJt Is no text. 

TO T New flle^ 

Tills parameter specifies tt^e data 
oytpyt file for tJie prodyct* For 
eKai^ple: file to iil^icfi a copjr utlMty 
Mfites* 

Single specified value parameteri 
defaylt = ii^¥* 

TEXT^RfSIDI^NCE TR Naiies of residences {!•€• f M es cr 

illsr arias) to fee searched to find texts 
specified by ttie T£XT.NAM£ parameter or 
by prodyct directives. Tfie total 
nymber of valyes a! I cued is prodyct 
dependent* If no text names are 
provided the first text of tlie first 
TEXTURES I DENCE naise Is tl^e on If one 
ysed* If text names are prowlded and 
TEXT.R£SID£HCi Is oisltted^ tfie defaylt 
for TEXTURES lOENCE will be the 
TEXT-HAHS parameter list* In case 
texts of dypi icate naises exists tlie 
first one foynd CIn the order in wiiich 
TEXT.RESIDENCE names are listed) Is 
ysed. For eacli naae In tlie 
TiXT.RiSiOENCE parameter list* the 
prodyct will look for a local file ulth 
that namei If not foynd# the gloisal 
library set Mill be searched for a 
library ulth that name* If the naiRe Is 
not foynd> as a file or library^ ^ 
fatal error til 1 1 occyr* 

Hyltlpie specified valye parameter* 
Default value list Is text name value 
list. 

example 1: If file Fl contains texts Ap C# and D 

and library 12 contains texts B and C 
and file F3 contains texts £ and A then 

TN=<AjB,C#0#£) and TR«(Fl^l2, F3) 
Hill result In selecting texts as 

fol I 0WS2 
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A^ Cm and from fi|« Fi 
8 frofli I Ifef ary LZ 
E from file F3 

Bnnmple Zi In tlie above e3«a«plej If In addition to 

a iibrary L2» the yser Nas « iocal flie 
nained L2 containing text^ B and Bs then 

TN«U#8#C^0>E) and TR« Cfi#L2#l^3) 
Hlii result in selecting texts as 
f ol IO*iS 

A^ C> and D froii file Fl 
B and E froi file 12 
nothing fro« llbrarf 12 
notlsl ni froai file F3 

TSR^INAl.TYPfi IT T«rislnal TyPe# 

TT«COR 

Correspondence Selectric Afl 
terminal • 

TT«ArL 

Tills t^fpe Is appropriate Mhen the 
co^inyn I cations system translates 
APL terminal codes into a standard 
interipedlate code. 

TT*ASC2I 

For f4jH ASCII tefflslnals not 
e<iui pped to print the AI>L 
character set* Also used for 
non-API correspondence teralnals* 

TT=UCA 

For ftill ASCII terminals. This 
avoids frequent use of the shift 
key for letters* 

TT^BATCH 

For devices tliat support the ASCII 
64-character set* Usyally used 
for batch or reniote batch ASCII 
pri nters# 

Single specified value parameters* 

Default Is API for a tlme-shirlni Job; 
and BATCH for a batch or remote liatch 
Job* 
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ViCTORIHATIOH, 
LEVfl 



Vi 



VeRIFY.H£R€E« 
INPUT.ORDER 



VMIC 



WORKSPACE 



M$ 



2.3 SQUaCi-IUElil 



V£CT0R2IATIQN tnti VEC Mt^ ncn-stan^ard aliases* 
Tills parajneter specifies the vectcrliation 
level* Tlie allci«ible options ares 

HIGH Prodyctlon-<iyaU ty co^e mith a bl§U 

level of vectorlzatlon Is senertted* 

IL or IHNER^IQCPS 

Qniy Inner loops are candidates for 
factorization* 

HONE VEC=NON£ cayses no vector Izatlon to 

be perforifted* 

Defayit = mm 

VERIEY and VER are non-standard and 
170 comp at I b 1 1 1 ty a 1 1 ases • 

Verify merge inpyt order* Selection of 
this option causes verification tli at 
Input records to bB merged are In 
correct order* Ttie foraj Iss 

VHIO=QN* Verify for correct order* 
VHIO=CFI=* Do not verify for 
correct order* 

Oefayit: VHIG==QI=F* 

Initial yorkspace specification* 

This parameter specifies the iiorkspace 
to be activated mhen the prodyct Is 
called* The paraiseter Is specified 
Mith valyes consisting of the foil on I ng 
parameters defined In the NQS/VE ERS: 

tl le 



This section deals iiiith the standard for the processing of 
source Inpyt flies by product set members* In this 
context# a file can refer to data originating from an 
Interactive terirlnai as Moi i as conventional storage 
devices* This standard addresses the areas of soyrce file 
organization^ statement formaty blank compression^ 9n4 
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TBsponsm to an «mpt3f Input file sityation* 

2.3.1 SOyRCS INPUT FIi£ QRGAHIZATION 

Soyrca inpyt to CYi€R 180 product s^t m^mb%rs lay b^ 
daslgnattd By tfie I dir active on ttie control stateiaefit. 
If tfie I dlrectlta Is omitted^ the source Inpyt defaylts 
to ttie standard Input ft la ibatcis mode) or terflilnal 
(Interactive sioda}* Tlie source Input lias a se^yentlal 
stfyctura^ and is accessed by iseans of %tBn4&r4 Record 
Hanager Interfaces* 

Positioning of the source Input at open time Is 
constrained bf the requirement to %H^m different product 
s%t ^effl&ers xlthln the saiae Job le«g« different ccnpllers} 
to access the saee file for their lnpyt» Therefore* the 
source Input Is opened »«lth nc-rei«lnd unless the renind 
ptraneter Is specified on the control stateiRent (see 
Keywords and Parameter Descriptions in section 2*2} • 

2.3.2 SOURCE STATEfiENT FORHAT 

Eacl^ record In the source Input contains one to three 
parcels of data: 

stateiRent Identifier ioptlonaDi 

line number <optlonai)f 

* statement body* 

Products should be able to handle the optional statement 
identifier and line nu)i;ber* 

The source Input statement may take the foil owing fcrii^s# 
wh ere 

b represents the statement body* 

I represents the line number* 

s represents the statement Identifier* 

and brackets specify the optional portions of the form* 

b I s 

s I b 
s b I 

I b s 
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2.3 .z.i ^iatmMut^l§MQklti&i, 

Input sayrc« records may contain optional statafflant 
idantlflafs syofc as SCU Identifiers* If present* they 
occypf either tl?e first or last »n* characters* where *n* 
has a mMuimum val ye of 18* If the stateisent Identifier 
occyples the Mst character pcsltlcns of a reccrd# all 
records ffyst he the seme length* The locatlcn and length 
of the Identifier &tb file attrlfcytesi they are wade 
avallahie via tn operating system re<iyest* 

This featyre Is to allo*« files created fey sowrce code 
ytllltles to he ysed as soyrce Inpyt. 



2*3.2*2 Liefi-.yyiiii:s 



tine nyphers are nunierlc entitles ysed hy coiipi I ers and 
editors. In general* editors mII I affix line nyaibers to 
lines Bn4 ccsspllers Mill yse these line nyishers for 
diagnostics* cross reference luaps* ryn tlae error 
messages* etc* ilne nymbers shoyld not he confysed ulth 
statensent Identifiers that are prodyced hy SCU and are 
al phany»erlc* 

The location of the line nymber In a text Ilne may te 
liiiwedlately to the left or the right of the text cf the 
line* The position of the line nysiber field Is conveyed 
via the file attrlbytes. The line nyiiber field way be 
from one to six characters In siz^&m The only valid 
characters In the field are blanKs and the decln^al digits 
to 9* Leading blanks are Ignored, k line nyaber Is 
terminated by end of field or one cr laore blank characters. 

Additional semantics for the line nymber field mIII vary 
from processor to processor* In parti cylar* lany 
compilers may not accept more than six digits* Another 
example is the cross reference mmp prodyced by CCN nhich 
only has space for a six digit Ilne nymber* Host 
processors mI 1 1 also Insist that the Ilne nymbers be 
yn I qye* ascending* and that every Ilne be nymber ed. 



2.3*2*3 SidtSfflfiCJ^-JfidJ 



The body of each soyrce Input record Is that part uhlch 
represents the data to be scanned or processed by a 
pr odyct set member* It begins In position I If there are 
no statement Identifiers* or If the Identifiers appear at 
the end of the record. Otherwise* It begins In position 
Cn+1) where 'n* Is the length of the statement Identifier. 
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Ttia maximum slae of the statement fccdf Is prodyct s«t 
pssibar dependent and conforais to ttit siza spaclfltd for 
tha issociatad language* Sour ca raoords shortar t^tn tha 
naxlfflijp MfB scanned to the end of the record* Records 
exceeding the ipaximyis siz€ are truncated (i«e* data Is 
transferred up to the mmnlmumU a diagnostic is returned 
by the Record Manager. 



2, 3 •2*4 iilQil.Cfil2£SSSii2B 



The CY8E8 ISO l?ecord Hanager |s responsll^le for 
coiipress Ion/expansion of blanks* The capaililty to read 
the source Input In compressed form Is not provided* If 
the re^ulrepent for this capahi I Ity e«ier§es Cfor 
perforfliance optlffilzation}^ It mIII be %44r^sse4 in a 
revision to the standard. 

2.3.2.5 £lltl.iOSiiJ:-£lll 

Diagnosis of an empty Input file results In the Issuance 
of a standard log messages EMPTY SOURCE IM#UT FilE 
(formatted In accordance Mith conventions stated In 
section 3*2). If the Job Involved is Interactive In 
origin^ the isessage is also sent to the tersilnal is%% 
section 3 .2*1. 2.1* In addltlonf generation of the primary 
output of the product set meiBber Involved (e.g* file 
specified by B parameter for coppllers) Is supp€Bss€4 and 
the SCI STATUS variable Irefer to section 2.2.4.2)# Is set 
to reflect the error. 

2.3.2. 6 ||yli.igU£fi§.Lla£.££J3Efi&liSQ 

The number of records in the source file siiouid be the 
same as the number of source lines In the source list* 
Even though a null record has no data# the record should 
not be Ignored. Since^ In the source ilst# the absence of 
all characters In a record looks the saiee as a record 
containing all blanks? nuil records sisould be mapped to 
al I blanks. 

2.3.3 DISPOSITION OF INPliT FILE 

The final action to be taken ulth respect to the source 
Input file Is dependent on the aianner of termination of 
the product set a^ember. For normal tar ml nation^ the Input 
file Is closed tilth the no-renlnd option; this Includes 
the case »«here an empty file Is detected* For abnormal 
termination^ the product set member Is responsible for 
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2»3.3 DISPOSITION Of IHrOT FILE 

positioning ttit inpyt file as I f fiormal processing liad 
occyrrad* yslns ^pptt^pf l^ts facilities of th« Recoril 
Han agar • 

Tha ysar of a Compiler roai control tarJoys activities of 
tk& compiler t>f speclfyini one or nore compile tine 
directives* Tlie directives are %tpfessm4 eltiier In a 
special form of a coffl^ent i«lttiln a partlcylar iannyage 
Ce.g. WQRlRAHp COBOL) or ]n special source statements If 
tNe iangyase provides such statements Ce.g* CYBILI* 
CoiPpllers that already iiave special soyrce statements for 
directives do not liave to process directives enlsedded 
Inside comments* Coffipilers Mhlcli non tiave compilation 
directives In ccfj^ments siioyld honor both old and neM 
direct I ves« Wien a compilation directive conflicts ulth a 
control statement parameter opt! on# the compliatlon 
directive overrides for example* the options for the 
parameter 10 mIII bm overridden tf a conflicting directive 
unless specifically stated otheriilse* sycli as LO^SA* 
However control statement parameters denoting file status 
or destination would take precendence over directives* 
For example tIST~$nyll Mould take precedence over any 
directives re^iuestlng that something l»e listed* 

Since the major programming languages are subject to 
standardization by bodies such as ANSI* flPSf and ISO# 
initial compilance with the form of compilation directives 
In this section may have to be altered in tlie event of 
standards covering this area. Because of the long term 
possibllty that the major languages will be different* 
full uniformity across 180 products Is unlikely* 
Therefore* products with CYBER 170 directives tl^at do not 
conform to the syntax contained here should retain 
compatibility *flth the CYBER 170 form to minimi j:e 
migration problems rather than cause a conversion In going 
to lao and possibly have to cause a second conversion to 
comply liith external standards* l^eN directives In areas 
Mhlch i«ill never be subject to standardization should 
foilow the form of this section. 

The Compilers support t%to general classes of directives* 

Compiler Call directives 

Source Embeoded directives 
As discussed In section 2*2* the directives specified on 
the command calling the compiler are established for the 



2-34 
CYBER 180 Systeip Ifiterface Stafidar^ 

84/02/04 

2.0 IHPUT 

2,4 COMPILATION DIRfCTIVSS 

entire coup II at ion procass* Thef apply to all sybse^iyent 
corapilation ynlts Iprograta ixodyies or suiroytlnss) Mlthln 

tha cofliplla Process* 

Soyrce eistieddad dlrectiwas are establJslia^ only for the 
co^pfiatlon ynit In Ntiicti ti^ey appear* Tliey ara eitpressad 
eltlier In a special form of a coni^ent Mitliln a partioylar 
I an gy age (e*f« FORTRAN^ €0301) or In special soyrce 
statements If the I angyaga provMes sycii statements (i«g« 
CYBIi)* Cofflpliers ttiat already have special soyrce 
statewents for directives do not liate to process 
directives ^mb24fiB6 Inside coaments. The syntax of a 
compiler directive »«ltliln a coisiient is ^s folloiiss 

$ directive C ^directive 3 * • • 

Exawple - FORTRAN soyrce embedded directives 
C$ directive - C In coiynn 1 

€xaiiple * COSOL soyrce embedded directives 
♦ $ directive - * In colynin 7 

Hyltiple directives ffiay b€ contained on the sa«€ Inpyt 
stateflgent* 

Where directives have parametersf they folloit SCL rylas* 

Soyrce eoifcedded directive format arrets are ^ilagnosed iilth 
warning or fatal class error messa^es^ as appropriate* 

The following standard ept^lles to compilers that process 
directives embedded Inside comments* A compiler Is not 
required to Implement all the featyres listed beloif» nor 
Is the list restrictive* 



2.4.1 PAGE EJECT 
EJECT 



This directive cayses the page line coynter to be reset 
to 1* yhen the line coynter Is reset to 1» a standard 
listing header Kill be nrltten on the soyrce listing prior 
to the next soyrce line* This directive mIII be listed 
before the p%Qt line coynter is reset to 1. If the paOe 
is at top-of-form when this directive Is processedt It Is 
processed as a **no~op*«. If a contlnyoys page Is being 
written* this directive Mill simply resylt In a triple 
space Mithoyt a new listing header. 
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Z.h^Z SOURCE IISTINC 



2,4.2 SOURCE LISTING 

LIST zn4 NOLIST 



The NGilST dirtctiire cayses ths listing of tlie source 
f!)odyi€# InQydlns compiler directives^ to ht suppresses! at 
tl^ls point* Tli€ LIST <lirectl¥e causes tlie listing of tl^e 
source module to resume at tills pclist. Tie directives 
LIST or NOLIST are listed at ttie point the:^ occur. 



2.4.3 LINE SKIP 

SPACE = number 



This directive causes tiie specified number af print lines 
to be skipped at ttie point in the source module llstlr^g 
tliat It Is processed. Tills directive mIII be listed 
before the skip action starts* If tlie p%%^ line counter 
Is exhausted before the specified nuail^er of I Ines have 
been sklppedj» tlie fine counter is reset to 1 and skipping 
terminates. 

number * integer value 1 thru n| If oialtted 

(including the »•«••}# the default Is 1* 



2*4.3.1 L1M£-S£lllliii 

SPACINS * numher 



This directive specifies the nuaiber of lines to be 
advanced before each source line Is listed. The ntn value 
for spacing mI i i take effect ult^ the next line folloiiing 
the spacing directive. Mhen listing a source tine If the 
page line counter is exhausted before the specified nunber 
of lines have been skipped^ the line counter Is reset to 1 
and skipping terns I nates* 

numbers Integer value 1 thru 3 indicating single^ 
double or triple spacing; If onltted 
(including the ••x*)# the default Is *•!•** 



2.4.4 TITLE LIHES 



TITLE = character string 

SUBTITLE = character string 

These directives define strings of alphanumeric characters 

In SCL format Mhl ch Mill be printed following the standard 

page headers on the source module listing (see TITLE Lines 

In section 3) * TITLE causes a page eject to occurs unless 
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tfet page Is alr^aif at top-of-for«i* TITLE Is listed at 
tlie top of the nem page* 

SUBTITLE also csyses a paga eject to occur* yni#ss the 
page Is already at top-of~forw or TITLE has Jyst l>een 
processed. SUBTITLE Is listed at tlie at the top of the 
page following TITLE If there Is one* 

Coiapllatlon Directives 

2.4«3 R4NGE CHECK 

RANGE and NORANGE 

The RANGE directive directs the cofflpller to generate 
additional ohject code which performs rente checlciiii for 
sybscriptsy Indexes* scalar asslinments* case varlalsles* 
etc. 

The NORANGE directive directs the coi»plJer to not generate 
additional range checking ohject code. 

The default for the c©r»pllat4on yi^l t Is HORAIIGi. 

2.4.6 EXECUTION TRACE 

TRACE and NOTRACE 

The TRACE directive directs the co«pi I er to generate 
additional object code nhich facilitates traclnn the flon 
of the program during execution. The TRACE directive Is 
Ignored unless the OEBUG.AIDSsTR paraiseter Is given In the 
product call coiinand. 

The NOTRACE directive olrects the cowplier to not generate 
additional floM tracing ohject code. 

Hlnlfnuip trace Infcrpatlon mIII alKeys he provided. See 
section 5 -4. 1*2. 

The default for the conspllatlon unit Is NOTRACE. 

2.4.7 DEBUG STATEMENTS 

DEBUG and NQOEBLG 

Source Input stetements that are to he coi«plled only for 
debugging purposes are enclosed between D^BUQ and NODEBUG 
directives. Enclosed source statements are compiled only 
If the DEBUG.AIDS«DS Is given In the product call cofflffiand. 



CYBfR ISO System If5t«rftc« St«rsdard 

86/02/04 



2,0 INPUT 

2.4.7 DEBUG STATEHiNTS 



2.4«a SlQUfNCi CHICK 

SEQUEHCi zn4 HCSEQUENCE 

Tlie SEQUEHCE directive dlrscts the coisplier t« €li«cic th« 
Inpyt sourc« ststaisent sd<iy&nc€ nyiefeers for ^9C^n4tng 
or<l«r* 

If a se<iy«nc« trror occyrs* It will be flagfe^J nitf^ a 
learning diagnostic* (See section 2*2»^«2} 

The NOSEQUENCE directive directs tlie cosipiler to ignore 
Input source stitement se<;iuence niiaibers* 

The default for tt^e compilation ypit is NOSEQUEHCE* 

The SE^UEHCE anil NQSEQUENCS lines themselves are not 
checked for se<iyence. 

2*4.9 OBJECT CODE LISTING 

OBJilST and NCC8JLIST 

The 0B4LIST directive directs the compiler to print the 
object code listing at this points The NOOBJIIST directs 
the compiler to stop printing the object listing at this 
point. The object code mI 1 1 appear In the object code 
part of the listing (see section 3. 3.41. 

OBJ LIST and NGCBJilST act independently of LIST and 
NOLIST. The default for the cowpllatlon unit Is I^OCBJLIST 

2.4.10 STACKING COMPILATION DIRECTIVES 

PUSH (coiapl lation directive! and POP 
The PUSH cofljmand nl 1 1 place the specif led compl I atlon 
directive on the top of the •'directive stacJc*. The PGP 
directive mIH remove the top directive froiR that stack* 
This procedure itl 1 1 alioK temporary alteration of the 
local environment Mithout peri»anently affecting the global 
environment* for ^^empie^ If it Is desired that a called 
common deck lists Its na^e on the print file# regardless 
of whether the entire common deck Is being listed^ then 
the follonlng Mould be placed In the common decki 

PUSH (LIST) 

comment Including comroon deck name. 

POP 
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2.5 EEsaya^oisiiiiim 

The foriRat of t^rodyct directives Ccoflnaai^dsJ «yst follon 
th€ set of langyasd rults and conventions of the System 
Coimnand Langyase. T^ese directives fre^iyently occiir In 
prodycts Coften warioys types of ytlllties) that are not 
c^fflpilers and are tliys listed separately* The standard 
pararoeter nawes as descrllsed In stctions 2*2«4»2 and 2«§»1 
pyst he ysed as appiicabia* 

2.5.1 STANDARD PAaAHETERS 

These parameters occyr fr©«iyently enoygfe to warrant oiaklng 
sure that all commands ysing then do so in the sasie Kay. 

Parameter 

Hanie Alias Paranieter Description 

BRIEF 8R This parameter specifies that a hriaf form of 

inforisatlon Is re<iyested for display at a 
teralnal or print file. It Is a feooletn ysed 
In ccnjynctlon Mith the full paraaeter. The 
hrlef selection Is ysed as the defaylt. 

FUil FU This parameter specifies that a full foris of 

Inforisatlon Is re<iyested for display at a 
terplnai or print file. It Is a boolean ysed 
I n con Jy n ct I on with the br I ef p m^ aaseter • 

COUNT coy This parameter specifies a coynt of ynlts le.g. 

flies records) associated Mith the command 
fynction. The default valye Is one. 

BILE F This parameter specifies the local file naaie of 

a file ysed as the object of a copisand 
fynction. It is ysed i«hen the file is not one 
of tlie specific files identified In section 
2.2.4.2 Ce.g. COMPILE^ INPUT). 

WAIT yAI This parameter specifies the re<iyest<>r shoyld 

be placed In a i«alt state If a reqyest can't be 
immeci ately processed {e.g. a file Is bysyl. 
It Is a boolean used In conjynctlon i«lth the 
none it parameter. 

NOyAIT HQU This parameter specifies the requestor should 

not be placed In a nalt state If a request 
cannot be imsiedl ately processed. It Is a 
boo I tan used In conjunction yith the Milt 
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2,5.1 STAHDARO PARAMETERS 

paranettr* Tha nonait stl^^tion Is iis#d as ttit 
defsyit. 

USSR US Tills parameter speclflts a user 

identification* It is tin ays tlie 3i*-cliaf aeter 

yser and fatnli^ napes bs specified t# iiin 
access to the system* 

PASSWORD PA This parameter specifies a 3l-character 

password needed to gain access to an entity or 
to execute a function. 

UPON This parameter specifies the local file fia«e of 

an output file* It Is used tihen the f]le Is 
not one of the specific files Identified In 
section 2,2.4*2 (e.g. tISTj BINARY-a84£CT) . 

LIBRARY LI This parameter specifies the local file naie of 

a library file I e.g. source I l&rary^ object 
I ibrary) • 

2.5.2 STANDARD COWHANDS 

These coissiands are required^ as a mlnlmuisf if the functions 
described hy the coffiir.ands are Included In the utility. 
Utilities may optionally Include allasas to the required 
command* 

Cowpand Oescrlptl*^ 

QUIT This directive enables the user to exit* or get 

out of> a utility* 
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3.0 mizui 

All products Mill fo4loM a uniform set of convent I oi^s for 
generated oytpyt# as specified liereln* All CY3SR 180 
products will use ttie faclNtles of tlie CY8ER 160 Record 
Manager for sucfi output. 

The use of hexidecljual numbers on output produced b^ CY10O 
software must Ise controlled to promote readalsl I lt^« All 
products Mill folloM the set of iuldellnes set therein* 

3.1.1 SITUATIONS AND RECOr^HiNOeO NUHSER 8AS£S 

h44rBSS.9 Address Offset: Hexldeciisal « When a lenitli is 

specified In conjunction nitli an 
address or address offsets tlie 
length is represented In 
iieildeclisal • 

Dayflle Infcrmatlon: Decimal statistics^ declaai 

resource fiffllts. 

Object Code LIstlngss 

Instruct I ons2 Hexadeclisal C4 or 8 liex digits) 

Operand fields: Decimal 

Branch Destination: Hexl declisal. The yalye Is the 

instruction offset of the 
destination Instruction father 
than the relative offset frow 
the branch Instruction. 

Instruction Offsets Hex I decimal . 

Core and file Dump: Various formats should be 

available^ including 
hexadeclnalj ascll# Integer^ 
floating point. 

Page nuiPbers: Decimal. 
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3.0 OUTPUT 
3.2 loss 



3.2 LQlai 



Ttia loss treatsd In tl^ls section art tliose maintained by 
tha oparatlng s^stea. Tli« OS provides interfaces to mt 
IteiRs Into ttie loss and the SIS profides conventions on 
horn to yse tliesi interfaces and on the contents of data 
put into tlie logs. 

Ttie set of logs Is divided Into two major classes^ 4SCII 
^r\4 fclnary- The ASCII logs contain only ASClX-tncoded 
data. The binary logs m&^ contain anf type of data* 

The logs inclydes 

- system log (ASCII! 

- job log I AS cm 

- account log (binary) 

- engineering log (binary) 
~ statistic log (binary) 

~ Job statistic log Cblnaryl 



3.2.1 ASCII LOGS 



Each ASCII log contains a set of records <ifii%T^4 by tlffit 
of entry Into the log. Each record contains several 
fieidsj some aytonatlcal ly provided by the logging 
siechanisflij and soipe provided by the caller of the 
n^echanisin. The folloMing fields Mte provided by the 
logging niechanlsm: 

- tlfiie of diy of the ^ntry of the record Into the log 

- origin of the message (cofflfnand^ prograffi*issyed# 
coiitfiiand fron; procedure^ etc. -~ that is: callers In 
OS rings »ay specify the message origin In the calU 
callers In usbts rings nay not mn4 their m^sstQts 
are always "progr ans-l ssyed**). 

The systeif? log has an additional systea-provlded field to 
Identify the message Issying Job. Also# eacli log record 
contains a field for data provided by the program making 
the record entry. 

Except for certain operating system programs^ the 
Interface to be ysed by the OS and product set for putting 
messages Into ASCII logs Is that provided by the *'aiessage 
generator"* a facility of the OS (see HOS/VE ERS). The 
message generator Is given a status record that describes 
the type of message and any variable data to be "edited* 
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3.2.1 ASCII ICGS 



Into tlie siess^ge* Tlie f^essage generator* 

- finds tt^t appropriate laessase skeleton In a library 
will eta Is In tlie current Job library list 

- edits the variable data Into tlie message 

- logs tlie final message In Mtilctitver tosts) are 
specified by a coiablnatlon ofs 

* destination specified ultbln tlie aiessage 
s!<eleton record 

* Job option selection le«g«# *lofl only errors*# 
'•log all ratals"* etc.l— • things sych as 
messase Importance ieyel mt^ defined In t^e 
message generator call* 

- displays ttie aiessaga at a terminal depending upon 
Job option 

The yse of a message generator easess 

- consistency of fflessages Mitliln and across prodycts 

- physical compression of i»essage tent 

- extraction of «sessage types for documentation 

- roytlng/syppresslon of aiessages b%Me4 upon laessage 
levels {e.g.> trivial* fatal# etc.) and upon user 
desire for only certain levels (••level •• or 
••Iniportance** Is specified In the usessage generator 
call* not in the message skeleton} 

- installation control over nhat kind of messages 
should appear 1^ the systen log 

Arbitrary user-Initiated logging need not use the message 
generator. 



3.2.1.1 Sistfiffl-Laa 



In addition to the basic system-provided fleidsi eacli 
systen; log entry contains a field Identifying the 
particular Job from which the message came or to Mhlch It 
ap p 1 1 es . 
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3.2*1«1.1 PURPOSE 

T^e prlffiary purpose of ttie system log Is to s^ry% bs a 
repository for Ififor (nation ragardins extarnai sf'staRi 
i^orkload. That i 5# the work tiia systa^ mms ask^d to do 
¥i a cojnfisands and tl^a lilgli ieval responsas of tMm system In 
regard to tha coi^pands* 

3.2.1.1*2 CONTENTIONS 

Tlia systan^ ion contains pradopinantly a sybstt of Jot) log 
pessagas that are of interest to the Installation. This 
norinaiiy Includes at least: 

- all systerr level commands f supplied bf OS) 

- all command completion messages 

~ start of each Job execution Isupplled by OSI 
~ end of each jcfe execytlon CsuppHed by OSI 
" rerun of each Job execution Isupplled by OS) 

- system Identification Isupplled by OS) 

* other inf creation supplied by the OS like data> 
hardware and software configurations and changes^ 
deadstarts> recoveries^ etc* 

The system log should contain only Indications of the 
major changes In state of the system %n4 of IndlyJdyal 
Jobs. 

The specific messages that should be routed to the system 
log in the default *'as-shipped** system mIII be determined 
on a case-by-case basis using these general conventions as 
qui del ines* 

Note that since message destination C^hlch logls)) 
Instructions are separate from the message-issuing code^ 
this determination does not Involve code modification. 

See Job Lcg^ Conventions for further guidelines. 
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3,2.1.2.1 PyRPQSS 

The purpose of tJie Jofc log Is to tiold a tr^QM of Job 
execution* Information concerning tfce nork re«iii«st«d and 
accomplished is recorded liere* It provides a syjimarf of 
the flon of ttie Job* pr obi ems encountered m4 cliarges 
accrued lay the Job* 

3. 2.1. 2^2 CQH¥€NTIQNS 

Keep lo^ messages simple and short. Use ttie logs for 
suwfliary Information. Use list files or binary logs for 
detailed or repetitive data. 

Messages lonser than the llstable oytpyt ••narrot^" for»at 
are discouraged. 

Sipiple cosipletlcn messageji that convey no nore Inforsiatlon 
than *»lt»s dona" stb not to be put into logs. In a bitcti 
castj coiRpietlon Is obyioys from the appearance of the 
next comniand* In an Interactive casej the OS ulil see tc 
It that the terilnal user Is notified of coapletlon. 

Completion messages that convey a small amount of ysefui 
or Interesting information are encouraged In order tc 
enhance tlie **!!¥€** appearance of tka system* ¥mf exampie# 
''23 records sorted. •• or '•Cycle 25 iisn4.*'m Information not 
specific to the operation performed should not be 
Included^ however ClIKe CPU time for a compllatlonK 

Messages (at least the non-brief mo^^ ones I should have 
the general appearance of normal sentences* That ls# they 
start Mlth a capital letters sre comprised of both upper 
and I oyer case letters^ and end Mlth a period, ilien Mn 
'^extended massage** of more than one line must be lssutd> 
each line should not> honeverf end ulth a periods but each 
sentence should. This faiiilliar sentence-type structure 
adds to the *»coiif or table" feeling that we'd like our users 
to h^we for our system. 

Accounting and iOM-levef statistical and hardMare error 
Information Is not to be placed Into ASCII logs except by 
the OS. 

Message-at-a-time "current status** messages Cllke 
"compiling alpl^a... compiling beta*.***) are not to be 
placed In logs. The OS hIII provide a means for programs 
to post these kinds of messages* The current message Mill 
be displayed at an Interactive terminal nhen requested by 
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tl)a teffsif^al ystrs* Pasting of these ^essa^es Is 
eficoyraged* 

TNe nesstse generator Nil! syppljr prodyot anil fliessaiit type 
idleotif i oat ion fcased upon the states reoord passed to it 
In a call* Products should not inoJyde this Inforaietlon 

In messages* 

ytien miQte tlian one datuin is to be loggedf try to minimize 
the nyfflber of pessages lines prodyced fey putting wore tlian 
one datuffl on a line* For exa^ple^ Issyes 

23 records sortedj Msr^e order 12 usB4i 14 Insertions* 

ratlier titans 

23 records sorted. 
Merge order 12 ysed« 
14 Insertions. 



3.2.2 8IHARY iOGS 



Binary logs are provided In order to alion the recording 
of log Information In a cosipact fcra; that Is readtble 
priiiiarliy by programs. Each binary log contains CYBll 
records ordered by time of entry Into the log. Each 
record contains several fjeldsy some aytosiatlcally 
pr Of Ided by the logging mechanlsff^^ and some provided by 
the caller of the mechanlsai. Tlie follo»iilng fields are 
provided by the logging iBechanlsia: 

- time of day of the entry of the record into the log 

~ the Identification of the Job froiB ulilch the record 
caae or to uhlch it applies (this field Is not 
recorded In the Job statistic log) 

~ the origin of the record isysteia or non~syste« — 
Indie at e s only Mh ether the call er I s Ins i de o r 
outside systein rlngs# not uhlch product or which 
systes; agency — this latter Information Is given by 
the ••Indicator of the type of record" fleld«l 

Fields provided by the caller Include: 

- Indicator of the type of record {e.g.# number of FTN 
source statements* SRJs at end of Job# etc«— the 
Indicator codes wiit be assigned and managed In a 
manner slinllar to tf^at used for status condition 



CY8ER 180 Syst€ii3 Interface Standard 

86/02/04 



3.0 OUTPUT 

3.2.2 BINARY tO€S 



codes as described In section 3* 4 I 

- veriable d«t« depending upon tlie record tipe 

Except for certain operating system prosraxisj the 
Interface to be used by tlie OS Bn4 product stt for pytting 
records Into binary logs Is that provided by the 
"statistics facility*' of tlie OS* Ti^e statistics feci llty 
Is given a data record ttiat describes the type of record 
9n4 any variable Inforipatlon associated uith tlie record. 
Ike statistics facility finds information about tlie given 
record type in a **table*»» This *table*» directs tlie 
statistics facility to do some combination of the 
following things* 

- ad d the y er i a b I e I t%m Is) to coyn ter C s ) 

- log accufpul ated counter values to a specified binary 
log or set of binary logs when a threshold counter 
value Is reached or Mhen a certain time has elapsed 
since the last •*put" to the loglsl of the 
appropriate counterCs)* The set of logs Is 
specified In the ••table*. 

~ simply log this record in the "table-specIf led** 
iogis) 

The yse of the statistics facility for binary logging 
eases* 

" Installation tailoring of Mhat Is considered to be 
accountlngy performance^ etc* data* For ^xample# 
site A may consider C^U time to be accoyntlng data> 
i^hile site B considers It a workload statistic and 
considers "nymfeer of statements complied* to fee 
accoyntlng data 

' optional routing of statistics to the Job statistic 
log (based upon user deslre> but constrained by 
installation Mllllngness — via •'table" 
information — to divulge certain Information) 

Since the statistics facility determines the log into 
Mhich a given statistic (for example^ PIDFR date) Is to be 
placed (based upon an installation and CDC defined tablel# 
system and product Implementors should not be concerned 
*fith which log(s) are used for ••their*' statistics* This 
mapping nil I be determined later* 
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3.0 QUI PUT 

3«2«2«1 Accoynt Loi 



3. 2.2.1 4££ayol;.L£ii 

3.2.2.1.1 FURI^QSE 

Tfit purpose of t^e account log is to litold accountlni Mn4 
bHilng Infcrraatlon* This consists of resources anii/or 
services usecj **Mho** used theie anfl **Mho** to ctiarge* The 



account log shout C i?e tl^e only 
Installation to do billing* 



log needed for an 



3*2.2.2 guaLQ§M.Ln§J.m 

3 • 2 • 2 • 2 • X 



rURPQSE 

The purpose of the engineering log Is to hold Inforieatlon 
regarding system hardware usage end errors. The 
engineering log should be the only log needed to perform 
hardware usage and error aniaysis* 



3.2*2*3 SiltiSil£.ififl 

3.2.2.3.1 PURPOSE 

Tt^e purpose of the statistic log Is to holds 

" detailed system workload Information 

~ detiiiad system perforisance Information {|*e«# the 
May the systeie responded to the MorldoadI 

Although soffle of this information Is recorded In other 
logs# a separate log Is maintained In order to^ 

- keep other logs relatively ^clean*» or oriented te 
their own purposes 

~ allow possibly larg^a aiRounts of data to be recorded 

In a cofflpact binary foris 



3*2 .2.4 iQh^^MtliUs,J.Q2 



3.2.2.4.1 PURPOSE 

The purpose of the job statistic log is 
the (global) statistic loy. The global 
contains Information regarding all Jobs 
may be read only by pritlleied programs 
Individual users^ however^ may Mish to 



similar to that of 
statistic log 
in the system^ but 
/ users* 
see Information 
that \s avallatle about their own Jobs* The Job statistic 
log may be read by normal programs / users and contains 
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3.0 OUTI>yT 



Inferfflitlof? re§«r<Hns m single Job^ slaMar to the •»s«0P€»» 
of tlie ASCII Job log* 



3*2*2«s Bij[iai:i-iai2.€iii}i£fiiii2&i 

A^old the use of ctiaracter data* Since eacN record type 
Is pre-defined by a CYBIi record type deflnltlonj tbere is 
se I dofiR a need to describe tlie vsrioys data fields ultb 
keywords or ttie I Ike* 

Message type naming follo%«s tfie naming contentions 
described In SIS section 3*4* 

Use the binary logging facilities for l>IDFR data* 

See the 03 ERS and tine SIS Usage Statistics section for 
nilnlfflym list of Items to be logged* 

Additional contentions nil! be added as design proceeds* 

3.3 LISIAaL£-fliJI£yi 

yfien a significant aisoynt of Inforiaatlon Is to be retyrned 
to tbe ys€r» It Is nrltten to a **iistabie oytpyt file** 
The standard format of sycli a file is described ^ert* 

CYBER 180 Qytpyt Standard Is defined in terms ofs 

Oy t p y t f lie Org an I z a 1 1 o n 

Listing P%§% layouts 

Page Header Format 

Format of Eaci listing Type 

Object Code and Debyg Code 

NS PAGE FORMATS 



3.3.1 LIST 



In the sections that follow^ the contents and fomat of 
the standard listings produced by CYBER 180 Prodycts ^r^ 
defined In terii!S of a vertical and horizontal iayoyt* 
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3.3.1.1 Vertical It^oyt 



3.3«1.1 ImLtiUMl^LMXQUt 



Vertical la^oyt Is defined In ter»s of t*i8 first prlntafele 
line of a forrR following top-of-foris positioning bf tlie 
printing dewl€«« Tills position is defined as line 1 of a 
form and Is resersred for the first print line of tlit 
standard listing Iseader. Tl^e prodyct ^s not responslfcle 
for the pliyslcal alignment of line 1 relative to tlie 
perforated fold on fan-fold printer for«s. This Is tie 
rasponslfell Ity of the ustr on printers ulth vertical 
positioning carriage tape aechanlsas or the responsibility 
of the CYBiR li€ CS Device Softnare on printers without 
vertical carrlase mechanises* 

When the last printable line of a fora has been written^ 
the prodyct will reset the page line coynter to 1* When 
the page line counter Is e^yal to 1* the neict print line 
uritten Is pr^ce4e4 bf a standard listing header ulth a 
top-of-form code In the first character position of the 
header print record. The product Is not responslliie for 
the physical allgnrsent of the last printahle line relative 
to the perforated fold on fan-fold printer forws. 



3. 3*1.2 £fi£.ill.4ii£ikUt£S 



Each product miist obtain the output file attrlhytes froffi 
the operating system at the time the file Is opened* 
These attributes Include print fliode# page Mldthj connect 
status^ page for^at^ and page length. Vertical and 
horizontal print density have operating system defined 
defaults Mhlcl^ nsay be changed by the ustfm 

Output flies isay be either continuous^ uhlcli lias a fine 1 
position but does not have a last line position^ or 
paginated (non-contlnuoys)* ^hlcfi has both a line 1 
positions and a last line position* Continuous fori 
specification files are intended for users using 
Interactive terminals (display or hard-copy) for llstable 
output. Paginated Cor "fan-fold") listings are intended 
for users using line printers for llstable outpyt* 
l=or paginated flles^ page length minus the nufiiber of lines 
of header detern^lnes the available lines p9r page* The 
operating system provides a (default) standard page length 
of 66 lines per page at 6 lines per Inch 
vertical print density* This provides an 11 Inch form 
length. Print mode specifies nhether or not the paginated 
file Is "burstabl e" or "non-bur stable"* with 
"non-burstable" being the default. 
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3. 3*1. 2 Foffflit Attrlbytes 



A c43ntinyoys forro file Is <letect«<i by clseckl ns tli« file's 
attribute pige fomat* C^rniected flies lilll defaylt to 
contlny®ys form fflode* but ysers way override tfeis by 
specifyli^s a page length for tiie connected file* 

3*3«1.2»1 CONTINUOUS OUTPUT FILE 

Mlien fornsattlng llstabie oytpyt for a continyoys form^ ttie 
prodyct yses a standard triple'-space code in ttie first 
cl^artcter position of tbe line 1 oytpyt record {ysytily 
the first line of the header I to achJeve top-of-for« 
positioning* Prodycts hIII reforioat listings for teriRinar 
ysers imlien reiylred by this standards 

Eac^ type of listing (source listing^ attribute listing^ 
etc.) Is preceded by a triple-space and ttie ysual lieader 
ilnelsl# but tbere Is not pagination as such* 

3.3*1»2.2 PAGII^ATED OyTPUl FILES 

Wlien formatting output for paginated listings^ tfie prodyct 
uses a standard top-of-form code In the first cliaracter 
position of the i ine 1 print record lysyally the first 
line of the header) to achieve top-of-forro positioning* 
In byrstable listing modtj each type of listing produced 
by the product Csoyrce listings attribute listing^ etc«ir 
begins at a top-of-f oriri position* In non-byrstable aode 
(sometlaies ref^rr^ii to bs **paper saving** isodel# eacli type 
of listing Is preceded by a triple-space and the ysyal 
header llneCs) if "proper space** renalns on the current 
page* **Proper space** Is defined es 6 p|ys the nynber of 
header lines {Insuring that at least 3 lines of output can 
be placed at the bottom of the page)| if "*proper space** 
does not refl;aJn# the triple space Is replaced by a 
top-of~forw« The source listing aluays begins at 
top-of~f orroj and user*specl f I ed page ejects I via 
compilation directives) always result In a top~of-for« 
position unless the listing Is already positioned there* 

3 « 3 .1 • 3 ^iiad ji:i2.£ii:i:lag£.Ci2Et£fii.Ca^ds 

Carriage control characters that are used should be 
restricted to the folloMing sets 

Character Action 

blank Space vertically one line then print* 

Space vertically tMO lines then print. 
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3.3.1.3 Standard Carriaia Controj Codes 



Space rertlcallf three lines ttien print* 

1 Eject to tlie first line of the next pai« 

before printing. 

-i* No advance before pr Intlngi allotis 

overprinting. 

Tf^ls set TMpret^ts tlie full extent of cowpatibi llty 
between cyrrent CDC usage and the proposed ANSI standard* 

Under NGS 180# tsoriiontel print density mn4 
vertical print density are file attributes that the user 
may modify. The NOS> I^QS/B£ carriage control codes S and 
T ill II not be ysed to set or clear the 8 lines par inch 

pode* 

It i*illl be necessary to n^ake some provision for selection 
of print density when NQS 130 print files Mf^ to be 
printed by H03 or N0S/8E. The first release of NOs 180 
will depend entirely on 170 state for print flies. 

3.3.1.4 UfiLlZfiQili.ilJCfiUi 

Horizontal layouts are defined for the standard Mlie foraat^ 
that is, IZZ columns. Assuffiinf a default density of 10 
Inches P^r seconds 132 co|y«ns uses 13.2 Inches of the 
standard 14^1 nc^ line printer paper *«ldth. 

Products Bf^ also reoulred to support t«o ter«inal foriaatss the 
standard ^Mlde forffiat*'^ 132 colufuns^ and the standard *'narroii 
forii>at**# 80 columns. Formatting for other line tildths In 
addition to the standard terminal line is pernltted. i^t I 
formats other than the two standard formats %r9 referred to as 
"other formats". 

The first character position of an output record is Interpreted 
by the output device software as the vertical positioning 
control character and Is never printed or displayed. The 132 
character positions foiloi^lng the first character position of an 
output record contain the characters to be printed or 
displayed* Therefor e* the character In the second pos I ton of 
the output record Is printed or displayed In the first position 
of the output i ine. 
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3»3«1.5 Standard List Ins Header 
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3.3 •I. 3 l^isailjci.Llstlfij.Maiifix 

All CY8ER 180 froducts nlll us« a stai^dard 2 Una pait 
haadar format on all listings produ€#d bf tha prodycts* 

Throygh tt?l s sacticn* date and tl«e flalds conform to 
standards defined In section 4*1* 

3*3.1*6 iIM£S-£a£MJIS 

If the line width specified is other than 80 or 132 
the heading Mill he fl^api^ed to one of the tuo stan4^f4 
listing headers* Other oytpyt will honor the aietyal line 
widths ynless specifically column oriented throyghoiit the 
line Cas opposed to col yarn oriented for the first portion 
and open ended for the last portion^ sych as soyrcel* 



line 1 

f I e I ds 



of the 
Ifleld 



ccffiffion page 
definitions 



Srsteii Nafi^e xlS) 

Prodyct Hame xi8) 

Pr odyct Version 9*99 



Product Level 99999 



Listing Heme x(14) 



header contains the fcllonlno 
are In COBOL format 3s 

Operating System name* 

The longhand foris of tie 

pr odyc t nape* I •e*^ FORTRAN* 

FHU# 8 ASIC* etc* 

Prodyct version numbmr m The 
nyinber after the decimal 
point Is shonn left 
jystlfied* l*e* 3*1# not 
5*01* This ny^her Is updated 
at the prodyct soyrce code 
level hy the responsible 
development organization for 
eacli nen version release* 

Prodyct modification level contained 
Mlthln the prodyct Itself* It Is In 
the form YYDOD representing the Jyllan 
date Mhen the prcdyct Mas conplled* 
This nyiaber Is ypdated by the bylld 
procedyres for each nen update release* 

Naiiie of the partlcylar 
listing being prodyced* The 
acceptable listing names are 
defined In the folioning 
sections Khlch define the 
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3.0 OUTf^UT 

3,3.1.6 QTHiR FORMATS 



formmt of €«cli llstl^i tjrpe 



Ho^ylt Na«i« jc(31l 



Oat S3 



itC18) 



llmQS 



nil2) 



Paga Nymber *PAGe« Z229 



Name of tl^« sotiroa isodylt 
tseing compllad or thd riaet of 
tie input file being 
proc#sse4« Tiie nodyle naiie 
is olit lined from the iRodute 
Ideiitlflcatlon statement 
provided within tite lafigyase* 
or» the ilefa«lt naae provided 
ttie prod yet tilien an 
identi fi cation statement is 
not ysed* This naiae need not 
appear in ttie first page 
header if unoistalnable* The 
na^e Mlii appear left 
Justified Mltliin the field If 
shorter thiin 31 oharaoters« 

Date at the tiae tise first 
header nas written (ITstlns 
f^age Nynher reset to II • The 
date Is obtained fro« the 
CY8ER 160 OS yslng a standard 
ProijraiR Hanagefiient re^yest* 
The date for»at Mlfl oonforia 
to the standard given In 
section 4*1* 

Time of 4%y at the time the 
first header was written 
(listing Page Nyisber reset 
to !)• The time is obtained 
frofs the CYBER 160 QS using a 
standard Prograie Hanaieiaent 
re<iyest. The time format 
Mill conform to the st»n4%r4 
given In section 4*1 • 

Integer number generated by 
the product starting at 1 and 
Incremented by 1 for each 
page header written for a 
compilation unit* The page 
number is reset for the first 
page h ea dec mr 1 1 ten f o r a 
compilation unit* This field 
Is omitted from the standard 
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header Mli«n a c^^ntinyoys fort 
is spacif iad* Tlia tMO parts 
are atnafs s^purated l»y Gne 
l3lafik* 



3.3.2 FORMATS 



Ti«Q logical Una width listing formats ara s^riaratad bif 
prodyctss 

faga Forraattad lines of 132 oharautars 

80 Coiyian Fcrpatted Unas of 80 otiaraoters 

3.3.2.1 Ml^fi.£fii:iaJ;«lll^-£filMffii2£l 

A standard tieader *«lll be written at the top-of-form 
position of a listing Mlienever the page line coynter Is 
reset to 1 except Mhen a contlnyous fore Is heing 
written* A standard lieader Mill be written onlf et tie 
beginning of a listing when a continyoys forn Is 
specified. A specified page Mldth of 132 or greater Mill 
resylt In the following heading line. 

FILE CCI^TEHTS LIST - WIDE FQRHAT 

Coiyrins 1-14 Listing Ha^e or Colymns 1^46 

program name 

Cofy^ns 16-46 Hodyle Nane 

Colyfflns 48-53 System Name 

Colymns 55-<54+nl Product Name (lengthen* n<24) 

Colymns (56+n )-{59+n) Prodyct Version {|engtti=4) 

Colymns {6l4n)-8<? Prodyct Level Clength»5> blank 

filled} 

Colymns 91-108 Date iright Jystlfied> 

Colymns 110-121 Time Cright Jystlfledl 

Colymns 123-132 *PASE* and Page Nymber Cright 

Jystlfied> 

All ynspeclfiad colymns contain blanks. 



CY81R liO Sfsttffl Interface Standard 



3-1 

86/02/0 



3.0 OyTFUT 

3«3»2*1 yide Foriaat 1132 colyfflns) 



FILE CONTENTS lEGISti - MIDE FORHAT 



C&lyians 



1-14 



Colymi^s 16-46 

ColyfflfiS 4a-S3 

Colyians 55-78 

Columns 80-83 

Colyflif^s 85-89 

Coiymiss 91-108 

Colywfss 110-121 

Colynns 123-132 

3. 3«2.2 tij£t:ai^£a£iJi.iiQ.CfiiuiQSl 



Listii^i Hmmm or Coiunns 1-46 
program name 

Hodylt Name 

System N 

Prodyct 

Prodyct Version 

Prodyct level 

Date ileft Justlfledl 

Tlpe ileft jystifledl 

PAGE and Page NyiBiser Cleft 
Jystifiedl 



Tlie prodyct i^iH I reformat tlie standard page fornat for a 
80 character line* A physical oytpyt line format 
greater tlian the specified line size may he rlftit-end 
truncated by the product to the re^ylred specification* 
The excess characters iiflll appear on the next ilne* A 
prodyct inay choose to reformat narrow listings lii thin 
the provisions of this docyeent. 

The header forinat {on termlnai formatted listings! 
consists of tMo consecytlve lines containing the fields 
defined aliove in the folloMlng positions on lines 1 and 
lines 2* The PAGE and Page Nysiher fields are optional 
for continyoys flies* 

This Infornnation will appear ulthln the following colymn 
positions of the first print line (Prodyct Naine^ Prodyct 
Vers I onj and Prodyct level are left Jystifiedj separated 
by one blank coiyinn}: 



I^IIE CONTENTS LIST 



Li ne 1 



Co I umns 



1-14 



Listing Na^e 



CYBER 160 Systeffl iriterfact Standard 



3-17 
86/02/0^ 



3.0 OUTPUT 

3m3mZ»2 Narrow fornat <80 CojyJ««sl 



Colyans 16-46 

Co I y urns 4i-6S 

Colymns 70-80 

Line Z 

Co I umns 1-6 

Co I mans B-il-nl 

Columns C9+i5> - ClZ^-nl 

Colyians C144n> - 42 

Colyians 48-65 

fILE CQHTiNTS LEGIBiE 
Lln« 1 

Columns 1-14 

Colytnos 16-46 

Columns 48-65 

Co I yarns 70-80 
Line 2 

Co I yians 1-6 

Colymns 8-C7-n> 

Columns C^^nl-ClZ-t-nl 

Columns C14+n>-42 

Colymns 46-65 



Hodyie Nsme 

Oatt irlflit Jystlfied> 

Page irJiiit Jystlfie<l> 

Systam Hama 

Product Ma«« €i&n§tk^nsn * 24> 

Product Varslon Clengtli « 4> 

Product Laval Clanstti«5# blank 
fl ll> 

Time Cright Justified* 

laft binnk paddad3 

-80 Column Format 

Listing Na^a 
Hodula Nam a 
Data Claft justif I adl 
Page Cleft Justif led> 

Sy stem Name 

Product Naiae ilensth=n^ n«24> 

Product Version Clength«4> 

Product Level Clengtli>5 blank 
fm> 

Time Cleft Justified, 

right blank padd«d3 
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3. 3.3 SOURCE LISTING FORMATS 

Tilt fo 1401^1 fig stafidard api^lles to compllerSf assemblers 
9n4 Interpreters* Assemlsldrs mai optionally insert binary 
information at the left of tl^e soyroe statawent* fage 
ejects 11^ ay be siippresse^ for sybseiiyent listings of eacli 
fflodyle Ce«9« Hapt Cross reference) if tbe source listing 
is short {e«g* 1/2 a page or less)* 

The number of records in the soyrce file shoyld bm- the 
ssffit Bs the nyiiber of soyrce lines in the soyrce list* 
Therefore^ nyi I records should b% mMPP%4 to ail blanks* 
<See section 2«3«2«6*) 

3 • 3 . 3 • 1 Siaai J£d.i;l£lllS£.£fiQt&QtS 

Every printable soyrce listing contains tlie foHoi«lng teict 
In the Listing Name field of the standard listing headers 

SOURCE list Cf 
— 14 characters— 

A standard soyrce listing header Mill be «iritten at th« 
next top-of~forfli position iiheneyer the page line coynter 
Is reset to 1* Only the first soyrce listing heavier will 
foe written on a contlnyoys foria. 

3. 3.3 ,2 IlILi.aa«J 

When soyrce embedded TITLE or SUiTITLE directives are 
processed^ the page line counter Is reset to 1 and a 
standard header Is written* The title text Is printed 
beginning In column 2§ 9n4 ending in colurun 132 of the 
line Irai^edlately following the first line of the standard 
header* The title lines Mr 9 folloned by a blank line* 

standard header — line 1 

title text — line 2 

sybtitle text — line 3 - 11 II f anyl 

blank — line n 

n (say take the valye 3 to 12> depending upon the 
presence of a sybtitle lines* 

When a source listing Is being formatted for a continuous 
formf the title line is simply preceded and folloiied by a 
si ngle blank I Ine* 

If a SUBTITLE occyrs without a TITL£# a blank line is 
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3.3.3.2 TITiE Lints 



plia^ed In tkn pissltlon Mhicli Koy|«l hawe &«tn occ^ypitd bw 
the TITLE. 

When ti^e soyrc€ Inpiit uiodule dots not contain a TITLE 
dlr€otlt8# tiio Isiank lines Impedlatfly to Mom tSie s#oond 
Una of the stsndard listing tieadsr. 



3.3.3.3 Mllift.£fi£iJj 



T^8 actuai source statement ilsting l^agSns on tlie tint 
fof Joiiing the Id lank line foil oning tfct lieader# or titles 
If present. Eacfi source listing print line contains ttie 
foilOMing optional fields^ 

Offset 118) A zero suppressed hexadecimal 

number isee section 3.11 givini the 
t)yta offset In code section of the 
first Instruction §«nerated for tiie 
listed source stateffient. If this 
field Is supported^ It Is selected 
by the list option SO. If 
se3ected> the field ssyst be 
supplied for all source listing 
lines. 



Input Line 

Number ZtlO) A numeric^ zero supprBMSB^ number^ 

up to 10 characters In lengths 
allocated to the source line. See 
section 2 •3. 

Left Statement 

Attributes xC4) Lan§yage dependent attributes. 

Rl ght Stateiaent 

Attributes x(4) Cofiipller dependent attrl bytes. 

The Source Record 
Is a required field 

Source Record xU32} Up to the first 132 characters of 

the Input source record. If the 
source line Is less than 132 
char ac t e r s> th I s field Is left 
Justified* Source Code Utility 
(SCU) Identifiers are contalpad 
»«lthln this field* If they exist* 
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3,3«3«3 yid€ format 

If all fields litre prtsent In a soyrce llstlo9# colyffif^ 
positions Mcyld bts 

ColyiBns 1-8 Offset 

Col yarns 10-13 Left statement attributes 

Colyjpns 15-24 Line nypfeer 

Columns 26-12S Soyrce <ln€|y<llng SCO 

Identification wlien present I 
Coly«ns 127-130 Riglit statement attrlbytes 

If an optional field Is not ysed tiie reisalnlng fields mIH 
be adjysted to the left* 

Whan the soyroe record C26-125) Inclydes SCU 
Identification Information ttie follo^ilng colyan positions 
will be B4herB4 to for th« soyrce record 

Co I yarns 26-105 Soyrce 

107-125 SCU Identifier* 

The fields shoyid not be changed (alxed) between 
sycaessive yses« Once the fields desired are estabiislied 
they myst remain ynct^anged* 

Existing fields before and after the soyrce record nay be 
blank. If the soyrce record overfloMS an additional line 
Is written Mithin the soyrce record field* In this case 
the right attribytes field of the first line contains 
^•••* as the first three characters and the rest of the 
field and offset field are blank* The overflon line 
contains blanks in the line nymber field and the remainder 
of the soyrce record left Jys titled In the soyrce record 
field* The right attrlbytes field contains the 
Information uhlch Koyld othemlse have appeared In the 
first line* 

3*3*3*4 MttUM^tiklBMt 

The soyrce listing format written on a terislnal formatted 
listing consists of one or lore outpyt lines for each 
inpyt soyrce record* 

The first line consists of the following fields^ 

Line Identifier Nynierlc right Jystlfied leading 

zeros syppressed* Optional 
variable width field yp to 10 
characters* 

Soyrce Record The source record field size Is 
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3.3.3,4 Narrow For««t 



dependent ©n the file attribute 
ffiaxinym record length and the size 
of the line nyrober field. 

A single hi anN separates these two fields. 

The source record field size is dependent on the file 

attrihyte fisaxlisyin record length* 

If the source record Is longer than the Soyrce Reoord 
field ther^ an acditlonal Line is written. The lines m% 
printed Mith the same foriaat containing blanks In the Line 
Hufliher field ^ntl the remainder of the soyrce line 
laf t-justif led In the Source l^ecord field. 

3.3.4 OBJECT CODE LISTING FORMAT 

This Is the fortiat for listing lines of ohject code 
produced by the compilers at the ysers re<iyest« 
Assemblers list their source lines fonsatted as syb#ltted 
froffl the Inpyt fi le. 

The object code listing shall talie one of tuo forias. The 
first consists of lines describing each CY180 Instryctlon 
embedded In the source listing anil# as far as possible^ 
following the same line frop Mhlcli the code Is generated. 
The object code line shall conform to the standard defined 
beioM. A group of object code listing lines shall be 
preceded and followed by a blank line. 

In the second fori^j* the lines describing the object code^ 
also conforxilng to the standard defined beloM> are 
collected Into a separate listing^ tht **ofoJect code 
listing** which shall conform to a page format coainon to 
the listings produced by all comp Hers. This Is defined 
as foilOMS. 

Object code listings consist of Instruction descriptions 

and coirsffient lines. 

Instruction Description 

With the exception of BOP Instruclonsj each instruction 
einitted Is described by a single print line optionally 
preceded and/or folloMed by coiiinient lines. The 
Instruction description mI 1 1 contain the fot toning fields 
In the following order* beginning In cofyain 2 of the 
11 stable output. 

Offset 2(8) A zero sup9Ttsst(^ hexadecimal nyisber 

{see section 3.11 giving the byte 
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3.3.4 08J£CT CQD£ IISTINS FCRHAT 

offset of tilt lnstr«otlon r^latlvt to 
an liRpI esi^ntation dafined bms%* This 
base sliat I be ttie sane base ysad in 
tiie offset field in the soyroe line 
Cif provided.) 

XCl) 

Inp^t Line 

Hypber ZIIZI9 The number of t^e Inpyt Sine for which 

the oode Is being generated las far as 
is practicable) « 

x(2) 
Binary XC20) An 4» 8 or 16-dliit hexadecimal nytsber 

Cadjiisted to the left) representing 
the binary bit pattern corresponding 
to the generated Instruction or data* 
For readability the syggested fori 1$ 
to arrange the nyinbers In groyps of 4# 
separated by blanks. The 4 and 8 
digit nufsbers are follotied by blanks 
to complete ttse field* For narroM 
fcrroat^ this field mIII not be present. 

X<2) 

Label X(3l} A I to 31 alpl^anysier ic character 

string Identifying the Instryctlon 
label as defined for tlie CY8€R 160 
assembler. The label field can be yp 
to 31 characters In length* It can be 
ysed jn an lispl ementatlon manner In 
conjynctlon Mith the coiopent field. 

X(2) 

Instryctlon X<1C) A character string Identifying the 
B(3) Instruction and Its operands. The 
X(2i) iDnefRonlcs to be ysed are those defined 
for the CYBER 180 asserobler. The 
mneironlc Identifier only may be offset 
by 2 or 4 spaces to distinguish 
Particular Instryclons of Instruction 
sequences, (e.g. to Identify code 
generated out of se«|yence with the 
source.) Operands are specified In 
the order defined In assembler 
specification which appears In an 
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Appendix Cto fee syppliedl* As siionn 
In tlie fornat desor li>tlon# tiie 
breakdown of ttie Jnstfuotion Is as 
foi Ions: 



HNEHQNIC XClOl 

xi3r 

OPERANDS XI2i) 

Xdl 
Cojiii«€iit XC2SJ An iwpl ewentffltlon dependent field 

typioaHf containing yser f mr I aiite or 
label identifier^ register yse 
cross-references* 

Harrow Format 

The narroK format and 80 Coluian For«at consist of the 
offsets line nijiiber> labels mneifionlcf operands and 
concatenated fields* The binary field i«l i I not be 
present. If tbe listed line exceeds 80 colynns the 
ilne Mill be continued on the nejtt line Icalled 
^foldlnfi**). for PN other than 80j the actual iildth 
specified mIM te ^onoredi excess Information Mill be 
folded. 

8dp Instruct Ions 

These are described by a line forsiatted as above# foi lowed 
by one or tuo descriptor descriptions* These are sliRiiar 
to the Instruction lines except tliat the jsnesonlc field Is 
blank Bn4 the operand field contains a descriptor In the 
form defined by the assembler specification* 

Comment Lines 

These are used to convey more information than can be 
accommodated In the comment field of an Instruction 
description* They consist of a comment field as defined 
for the Instruction description. 

Every printable object code listing contains the folloMing 
text In the Listing Name field of the st%n4Brd listing 
header^ 

OBJECT LISTING OF 
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3»3»4«1 Sti«<isrcl Header Contttits 

—20 ctiaracters— 

A staniiard object ilsti^s ke^^^t i«l II b^ written at tli« 
next tof of-forw posltloi^ iifeenever tlie pase Una counter 
Is reset to 1« Only tlie first object listing lieader nili 
be written on a continuous form* 

3 • 3 • 4 • 2 itsad Jid-Ifist £y £iliis-£iiifii£iiias 

Ike instruction meniRonlcs ysed bf tlie coiipliers Mill b« 
tlaose of the CYiER 180 assa^bJer. 

3*3.5 ATTRXBytfiS ilSTlNS FQRnAT 

A coBiPon format for tt^e Attribute/Cross Reference listing 
Is defined tiere* It Is useable by all currently planned 
languages for tie Cyber 160 and provides enougb 
flexibility to tailor portions of the listing to 

individual language needs* 

The content of tJie Attrlbytes Listing nil I vary sllgtitly 
depending upon nhetl^er Cross References Mere selected or 
not^ but the essential foriat mIII be the saise* If t^e 
user selects both attrlbuas and refer^ncesf the norial 
format will be used* yhen references are not salected# 
the heading nlll reflect the differences but th« foriaat 
Mill not vary* If references are selected^ but not 
attributes* then some of the attribute Inforwatlon 
provided mI II not be listed* providing sowe additional 
space for references on the line* 

3*3*5.1 ^tmiMLS^^US&^&t^Zmt^U%^ 

Every printable attribute listing or attribute/cross 
reference listing contains the folloMing text In the 
listing Nai^e field of the standard listing headars 

ATTRieuieS CF 

14 characters 

If no attribute list Is selected Ccross reference selected 
only) the foil citing text is placed In the listing Naiae 
field Instead: 

REFERENCES CF 

14 c har act er s 

A standard attribute list header Mill be Mrltten at the 
next top-of-foriR position or folloMlng a triple space* as 
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3#3«5.1 Standard H€id«r Contents 

specified by sections 3*3«1«2.1 and 3«3«i.2»2# and 
wliin«¥er fcl1oi«ing page breaks occur. Only the first 
attrifeyte list iieader nill be Mritten on a continuous for»« 

The standard hM§4et is followed b^ a blmk line and one or 
pore lines containing tlie attribute/cross reference 
listing heading* Tl^ls consists of tlie field descriptions 
as defined In ttie next sections^ separated by one or nore 
branl<s« Nyiuerlc fields In t^e listing mre rlgbt-allgned 
*«l til the rlgl^t-hand side of ttie description! cliaracter 
string fields are aligned on the left> lihere appropriate* 
Soine of the field descriptions s^ay be split betueen tifo or 
more lines If reciyired* or omitted^ If necessary^ as 
Indicated be ion* 

3, 3.5,2 MM&^tutmt 

Tlie listing Is «ade yp of entries describing tlie objects 
defined In the soyrce program* Each ^ntry consists of a 
definition llne> followed by one or more extension lines 
if re«iylred« The definition line gives the line In Mhlch 
the object mBS declared Cor first referenced If l^pllcltlir 
declared)^ the Identifier^ and attribytes. Extension 
lines are ysed If there are aiore attribytes than can fee 
accoflsffiodated on one I ine» and to hold references If 
selected. If both attribytes and references are selected^ 
the references eliiays begin on an extension line by 
themselves* 

The lines contain the fields described In the table bei0M# 
In the order specified* The table also contains the field 
description to be placed In the table heading* Tlie final 
section of the line (for host syppiled free fori!) 
attribytes and the references) Is contlnyed on extension 
1 1 n es e^s ne ces s ar y • 

Entries occyr In alphabetical order with a blank line 
Inserted between groyps of Identifiers starting Kith the 
same character* Kyltiply defined Identifiers are 
consecytlve In order of Increasing level of nesting or In 
order of occyrrence of block. 

Variable format fields are optional* They are In the 
Indicated order If ysed> otherwise the field Is not 
present* The sizes for the given fields are maxlsiyft width* 

ATTRIBUTE/CROSS REftRENCE LISTING flElOS 

Fi xed Formats 
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Field Haadlrii 

Identifier IDENTIFIiR 



bl ank 
definition 



OEFIHED 
m LIME 



Size 

XC31) 

X«l) 
U5} 



size 



SIZE ynit 



X(ll 
XC3) 



Haaning 

Ttie I dent If I er of the entity* 
The name appears left Justified^ 
blank filled* 



The soyrce Una n^^ber in Mliicli 
tlie entity m^s defined^ or (for 
langyages Mltti Isipllolt 
definitions! first us%4» It nay 
extend into the Identifier field 
If larger than five IS) digits* 
The second line of the heading 
-ON LINE- Mppe&fs only In the 
Hide forest* 



Size of the @ntlty# In unltsi 
defined by the host (either blts# 
bytes^ or words) • The ynits of 
the size of the entity mI 1 1 
appear as *»8IT««f "8YT£«j or 
«yORD«* Abbreviations are 8IT# 
BYT, WRO. Normally the fields 
for size unit coisblnat Ion nl II be 



size 


2(81 


blank 


XCll 


ynit 


Xt4) 



If the size field exceeds 8 
digits, then the fields Mill 



be 



Special 



size 
un 1 1 
case* 



zdoi 

X(3) 



If size units Is no-si ze# then 
the size field Is allowed to be a 
signed Integer (&4'-blt)* This 
Mill be right Jystifled ynder the 
SIZE title if possible* If It Is 
too large. It ••grows'* to the 
right* If It is so large ^s to 
groK Into the TYI>£ field, the 
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3#3«S«2 yide Fofffltt 



bi ank 

type of 
entity 



TYPE 



XC2) 



XUO) 



bl ank 
I 0€ fit ion 



iQCATICN 
SEC+OFF 



XCl) 

Hinloiyi!! 
X(6) 



TYPE field is pystied to tiie 
riglst* This is possible beoeyse 
tNe LOCATION field Is yndefli^ed 
if tlie SIZE ynlts are no-sl2e. 



The tyi>e of ttie entity being 
listed. Cfiosen from tlie list In 
section 3«3«5»4«lj If tlie liost 
Mishes further ^yal If I cations 
listed they %pp%%t In the 
attrlbytes list* 



Ttie location of tlie entity^ 
nhert ••SEC* Is the section nim% 
of the section containing the 
data for the Identified 
reference^ and "off* is the 
offset to the beginning of the 
section* The section nases are: 

$LIT£RAl The section 

containing I Iteral 
constant data* 

$STACK The section 

containing variables 
that are allocated 
on the stack lihen 
the containing 
procedyre is called* 
A sybset of the 
SSTACK section 
containing paraneter 
list variables 
allocated on the 
stack by the calling 
procedyre* 
The section 
containing variables 
that are statically 
allocated^ are not 
in coiBisonj and are 
not In an explicitly 
named section* 

$R£€IST£R Variables not 

belonging to any 



SPARAMETER 



SSTATIC 
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Variable Format 



ffiemory section but 
e^isti fig only In a 
lierdMare register* 

$3INDIHIS The binding section, 

SSLANK Blank Cunna^ed) 

co^ipon • 

CYB$0£FAyLT 

H£AP The system lieap* 

Code section names nill be set to 
the name of the procedyre the 
section represents* iSs^r defined 
names of section Mn4 yser 
declared conmon blocks mIII sIso 
be specified In full lyp to 31 
characters}* 

yhen a "sec** name Is too large to 
fit Into the defayft field size 
alio cat ed> the entire name Is 
printed^ expanding to the right* 
A line feed and re-allgnaent 
"back" to the next listing field 
alioNS continuation of cross 
reference date generation* for 
narroM forisat (section 3«3«S«3># 
If the "sec* name does not fit on 
the linej It Mill be put on the 
next line by Itself^ then the 
rest of the mBp nlll continue 
following a line feed and 
re-alignment to the next field* 



For narrow format listing the variable format fields^ 
continue on a neu line beginning In colymn 15 and 
extending to column BO* For lilde format listing the 
variable format fields continue on the same line beginning 
In column 7 5* 

Field Heading Size Meaning 

block number SLOCK Z999 Specifies the block or subroutine 

In Mhlch the object Has defined* 

blank XI2) 

nesting NEST 2ZZ999 The nesting iewel of the 
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3.0 OyT^UT 

3.3.S.2 M1d« Format 



|i«ir«l 



tfVEl dtclaration of the entity If m 

i>loc)<-stru€tyrad langya^a* If 
t^e tiost is not a block 
stfuctyred langyase^ the nastln; 
iBval Is oaltted. Ttie ssoond 
line of tlie heading - LiVit - 
appears ^n^w In the wide forisat 



b\ ank 

containing 
entity 



CONTAIN OR 
DECIAREP IN 



XI 2) 



XC31I 



hi ank 

basic 
attributes 



ATTRIBUTES 



X<2) 



X(12) 



user 
attributes 



references 



The naaie of the containing or 
<iuallfylng entltf* Blank If the 
entity Is not contained or 
qualified* The **contained 
within* fora i% for arrays and 
structures* The *'decl ared In* 
form Is for local yarlables* The 
entire heading Is on one I lne« 



The **feaslc attribute" of tie 
entity lentryj externals etc*l 
chosen frois the list In section 
3.3.5.4«2* Blank If 
no n - app 1 1 c ab I e to the ent I ty • If 
there are no optional fields and 
the basic attribute Is not 
presents the Mhole line Is 
omitted In narroti forsiat* 



free Other host defined attributes 
field separated by commas* These 
start- attributes begin on a 
Ing on separate line beginning nith 
a sepa- coluflin 54 for Mide format and 
rate €olu«»n 15 for narrow foriaat 
line ilstlncs* Each definition 

specified by the host Is placed 
on one line If posslble> 
otherwise each that over flews 
starts a new line* If the 
definition doesn't fit alone» It 
is broken at a blank* 



R£F€R£NC£S Z(6)XC2) References on the Identifier 

For coniblned line begin at coluiufi 54 on* 

mMPf subheading the listing In narrow forisat 

will be the first line has two 



Cno heading) 
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3.0 OUTPUT 

3. 3. 5,2 yid« Format 



rafe ranees* Subsetiyefit 
^•REFS*'^ lines start In colyron 15 

starting on an<3 l^ave six references per 

a separate line* In ml 4m forsiat mti 

line* lines start In coly^n 54 and tia^e 

B references per lint* For nixed 

mode listings^ see disoyssion 

be I on* 

Ttie format for referenoes Is a six diglt# rl uht 
Justified^ blank filled Integer* folioMed bjr an 
optlonisl stasis 1/)^ foil cued by <|yailfjrlng letter* 
cliosen ffoai t^e list In section 3«3-5.4«3* This 
combination is folloMed hy a blank* 

In ffilxed mode Ccomblned attrlbytes and references!* 
both the attrlbytes Mn4 references mrt handled as 
described above* except that the first reference line 
has a sybtitte -REFS- placed at its left* The sybtltle 
-RFFS- Is placed In col yarns 9-13 on the narrow listing 
indi In colywns 48-52 In the iilde listing* 

Since the user m%f select the attrlbytes listing 
separate frcn the references listing* the folloiiing 
changes occyr Mhen both are not selected together* If 
attrlbytes only are selected* the references are not 
listed* If references onljr are selected* the 
Identifier* line nysiber and references fields are us%6 
and the references begin at the end of the first line* 
not on an extension ilne* 



3.3.5.3 M5£taii-£a£ili 

The narrow forfl^at listing ifill have the same format as 
the Kide listing iiith the exceptions noted In t^e 
descr ibi tlons in section 3*3«S«2* and ulth the 
exception that the attrlbytes and refernces fields Mill 
continue on an extension I Ine beginning In colynn 15 
and extending to cciymn 80. 

3.3.5.4 staadl£d-£X£id.)tJiyfiS 

3.3.5.4.1 ENTITY TYPES 

Each entity is assigned a basic* cross-langyage type* 
These appear in the **Type** field as one of the folionlngi 

TYPE ABBREVIATED FORH 

Simple var* VAR 
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3*0 OUTPUT 

3. 3. 5. 4,1 ENTITY TYPES 



Arrays ARR 

Stfyctur«* STRU 

Mewlstf* H£H 

Cof^dltlon* COND 

Cons tan t:» CONS 

Typ«* TYPE 

DEFj Oif= 

Prosraai* PROG 

Module MOD 

Pfoc8d«re# PROC 

Fynctlofif FUNC 

Labels LAS 

Swltcii^ S«CH 

Flls> FILf 

Forwat# FHT 

Psrasrapht PARA 

Section^ SEC 

lmp\ nafiie# (for IkpI ementor nasie) IMPt 

Groypf SRP 

Alias ALIA 

Error ERR 

Attr na»e# ATTR 

Ea€i host need not support all types of entitles on this 
llst# liyt shouiii define a consistent mapping Into a subset 

of the above* The final entry {••Error^'3 should be us%4 
for entitles whose definitions contain syntax errors 
sufficient to prevent the compiler from deternining tl^e 
user's Intentions* 



3.3.5.4,2 BASIC ATTRIBUTES 

Tills field contains attributes basic to the entity 
d3finltlon xhich %r^ exclyslve of one another. If the 
entity does not fill Into one of the follOMlnf catagorles 
of attrlbutesf then the field Is left blank. These are: 



Attribute 


Ab br e 


undefined 


UNOEF 


unreferenced 


UNREF 


EntryPoInt 


ENTRY 


External 


EXTRN 



Hone (field is blank) 
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3,0 OUTPUT 

3.3,5«4.3 Ril=ER£NC£ TYPES 

3.3«5«4.3 REFtRENCE TYPES 

Th€ standard rtference type abbreviations will fees 
H the entity was set (n^odif led># 

(iDlanlc)^ the entity was used Islasfi is also omitted) 
A the statement defined an entity attribute^ 

S the entity was a sybsorlPt ©r index^ 

I tk^ entity Cusyal ly a file) mms referenced In 

an I/O statement 
R ttie entity was read into <or# If a flle# nas 

read) 
y tlie entity as nrltten froia (or# If a flie^ nas 

ur itten) 
f^ the entity i«as ysed as en aotyal parameter 

For all listings containing references tisere Is a legend 
of the possible reference types and ttieir one ctiaracter 

abbreviations at the bottom of each page* This legend ts 
right jystlfied and takes the for» abbrev « full naeej 



« » « 



For examples H^modlfyj A=attribute# S-sybscrlptf 
1=1/0 refj» R=r€ad> W*«rlt«# P=pararo« 

Each host may cf^oose to yse the entire set or a sybset 
thereof J tyt It Is hoped that most hosts nil I yse the 
entire set* 



3«3.6 DIAGNOSTIC LISTING 



Ttie diagnostic listing for compilers* assembiers^ 
Interpreters^ etc*^ consists of diagnostic messages* 
Diagnostics are listed in either of tKO podes^ at the 
host's choice* The first niethod lists all di agnostics and 
a diagnostic syirinary at the end of the listing* fol loKing 
the Attr Ibyte/Ref erence list (If selected). The second 
method lists syntax diagnostics In the soyrce listing %s 
tNey are detected* ulth later (non-syntax) diagnostics and 
tne diagnostic symiriary being listed at the end of the 
Attrlbyte/Ref erence list. If the first method Is 
sa I ecteti# the host may also choose to have the location of 
the diagnostic occyrrence flagged In the soyrce listing 
(by means of a caret symbol ynder the offending column)* 

^hen compllatior! occyrs xith zero diagnostics a diagnostic 
symmary Mill be prodyced consisting of the single line *N0 

ERRORS*. 
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3.0 OUTPUT 

3.3«6«1 Standard H€Sd«r Contents 



Every printable error I Istlng/su^pary contains the 

foi losing text In tlie listing nane field of ttie standard 

listing headers 

ERROR LIST CF 

-—14 har 8€t er s 

A standard error listing header nil! be i«rltten at the 
next top-of-fori position or followJnii a triple spacer as 
specified by sections 3«3«l*2«l and 3«3*1«2»2# and 
whenever a SMbseqyent page break occyrs* Only the first 
error listing header is written on a contlnyous forn. 

All diagnostic listings^ iihettier groyped together at the 
end of the other listings or printed Interalxed ultli the 
soyrce listing »«lli have the saise hasic foroiat. yhen 
groyped# they Mill he listed In soyrce I Ine/stateiient 
CO I yiiin /diagnostic ny^her order. Mhen groyped and the 
diagnostic nymher Is not haing printed^ they mI 1 1 be 
listed In soyrce line/statement colyfsn/order of Issyance 
order. I^hen printed IntermlKed tilth the soyrce listing^ 
they Mill be printed in the 0T4^f the host detects theis. 

Colycnn positions are specified for the case Mhere all 
fields are ysed^ and rei^ain the same If an optional field 
is not used. 

Col yflin 

Position Contents Fcrr*at Heaning 

1-9 I eye I Xt9) error severity level of the 

dl agnostic 

11-17 line nr * ZI6)9 soyrce statement nyiiber on 

which the error occyrred. For 
diagnostics Inter i»lxed ulth 
ti^e soyrce II stingy this field 
contains * ERROR*. 

22-24 diag. no. IZ99 diagnostic nywber of the error 

{assigned by the host). This 
field Is optional • 

26-2S COL X(3) The abbreviation for the word 

coly^n In Intermixed (mode. If 
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3.0 OUTPUT 

3«3«6«2 Standard OMgiiostic ilstin§ Foriiiat 



tkB cciynn nypiser flaid 
contains 2ero# *COL» is 
syppressed. In iroyped mii4% 
tNIs fleid contains til a col ynn 
ny^bar dascrll^ed beloM^ and 
that flaid Is blank* 

30-32 col« no* ZZ9 colymn nyflJbar In whlcfe tha 

error was datactad* Blsnlt If 
not applicable* In group €4 
mode ttie colymn nyn bar is 
present In tlie col 126-28) 
field and tbe colynn nyi^bar 
field Is blank* 

34-eol text ttia diagnostic text Cdafin«d 

by tbe hostr* Eacli Mord 
14 1 1^ In the text Is separated 
by one space and th€ line Is 
filled as reqyired* Extension 
lines begin with the text 
position tisroygh the end of 
the I lne# single-spaced* In 
intermixed mode* the TERROR* 
Indicator is re-lssyed on 
extension I Ines* 

Diagnostic symn^ary for products that ysa diagnostics 
Internlxad i«l th soyrce sjioyld Inclyde a page list of pages 
i^ith diagnostics* 

3.3*6*3 lt£aiJ Jx:d.OiJia&fisilfi.iMffiiajLi.£atiai 

Tlie diagnostic summary villi folloi the diagnostic listing 
for groyped diagnostics^ or stand-alone for Intermixed 
diagnostics* In either case It provides the us^r Mith a 
summary of diagnostics detected and 1 1 sted» as directed by 
the EL paraiseter* 

There Mill be an diagnostic syminary line for each level of 
diagnostic detected dyring the compllitlon* If no 
compilation errors (at any level) Mere detected^ then that 
Is noted* The follot«lng format Kill be ysed for all of 
the symmary i Iness 

colymns 3-6 **♦* Suaimary line flag 

colyfBns 9-14 Number of diagnostics of a 

given category* In the foriiat 

Z(5)9* 
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3^0 OUTI^yT 

3.3«6,3 Stai^dard Diagnostic Smmzry Fcriuat 



colypns 16-eol Text^ In the format *'aafia 

di agnostics**^ n^ere aaaa Is 
tt^e category being 
suianarlzed* If the 
diagnostics Mere not listed 
(dye to EL setting) tfien 
••Cynl Istedl** is appended to 
tlie nessage* 

If only one diagnostic at a given level nas issyed^ the 
word •'diagnostics** will be "diagnostic** In tlie inessages 



3.3.7 COMPILATION aPTIQNS 



The coflipllers kII i produce one or «or# lines of oytpiit to 
Indicate mhich control stateaent options nere selected for 
this contplle (elttier by defayit or eKpilcltlyK Tlie 
format of this line will reflect section ZmZ of t^ls 
standard* This line lilll appear after all other listings 
for eaci) isodyle. It is produced ulienever any list option 
Is selected and not produced for LG*NaN£. 

3.4 ££EOS.i£SSM£JS 

Tills section describes conventions for all ASCII error 
messages. Ttils Includes log messages Cto system and Job 
logslf Interactive messages^ and error messages written to 
tlie OUTPUT or other files < reference logs» section 3*2). 
The conventions Include tlie use of the Hessage Generator » 
n;dssage Identification^ and message nordlng. 

3.4.1 CONDITION COOES* £HB£DOEO PRODUCTS* AND MESSAGE GENERATION 

3.4.1.1 gmiitlau^QM&& 

A summary of the NGS/VE status record fields Is noted 
belo)^. The NOS/VE ERS should be referenced for a complete 
description of the status record and the Hessage Generator 
Interfaces. All products* Including products embeded In a 
host products shall adhere to these conventions* 

Normal - A boolean which has a value of FALSE if a request 
could not be processed correctly and TRUE If it has been 
pr o ces s e d c or r e ct I y . 

Condition Code - A unique condition code Is defined by a 
two-character product Identifier (see section 4.1.1.1I 
plus a flve^dlglt error code Indicating the specific error 
{e.g.* IDnnnnn). All CDC error numbers must 
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3.0 OUTPyT 

3«4,l,l Condition Codes 

ba In the range 1 to 9999* Error nyiabers In the range 
10000 to 19^999 are resery^d to identlff errors fro» user 
developed products* 

In cases Mfeere t*ie condition code Is conwynlcated 
In a fori other than a status record Ca.g., FORTRAN 
I03TAT* AAM»s El fleldl the field "condition* fro® 
the statys record must he ysed* 

Text - A strlns ysed to sybstltute text Into the error 
message template associated Mlth the condition* The first 
character of the text signifies the character ysed as the 
text delimiter* AM text Itesis ztb terminated by the 
delimiter or the en4 of text* 

3«4.1.2 EBk&M&4^EtQiM&tS 

The embedded prodyct should retyrn abnormal conditions to the 
host via the standard status variable^ and with condition code 
and product Identifier of the embedded product* Conditions 
anticipated by the host should be translated bjr the host into 
the appropriate condition with the host product Identifier and 
condition code Khere user action Is required* Conditions not 
anticipated bf the host can be passed on to the user* 
Conditions issued by the emb%4ii^4 product should be clear enough 
for the user to determine required corrective aotlon^ 
Including the r^€B6 for ^%R submittal m^^rB appropriate* 

3«4«i«3 Mssj2£-iiJQSf:ati££ 

The NO$/V£ Hessage Generator Is used to format and output 
all error messages output to logs or to an Interactive 
users terminal (note this does not Include diagnostics 
generated during compl I atlon)* It produces a standardized 
message using the NOS/VE status record and message 
templates from a message dictionary* 

3.4.2 HESSAGE TEXT 

The message templates are determined by each prodyct and 
included In a message dictionary* The NOS/VE ERS should 
be referenced to determine the formats of message 
tempi ates* 
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3.0 OUTPyT 

3.4. 2.1 Message Formats 



3.4.2.1 MS^MSi&^Qm&X& 



Jh^ ffiessage ientrator fortnats and outputs messages 
accisrdini tQ cofiventiGns based on tfie message's 
destinations terninal^ log* flle# or retyrned to 
eal ler • 



the 



Terminal 



Formats 
£x ampler 



text ••••« or 
Permanent file 



IDnnnnnn 
Cpfy> not 



text 
foynd* 



« « • . . 



tog^ QUTPUT^ or otl^er files 



formats 
£x ample 



IDnnnnnn 
C80326 



Re turned to cai lers 



Forisats 
ExamPJe^ 



IDnnnnnn 
AH1234 



text * . . • ^ 

Incorrect 

assymed. 



SID 
SOP 



deilinlter* comma 



text ••••• 
File llfnl 

opened. 



al ready 



Where* 



text ..* 

ID 

nnnnnn 



SID 



Text of 1^ ess age 

Product identifier 

The error condition code 

lynique error nymber for a given 

prod yet) 

froduct sybldentif ier 

Sybcondition code. 



The combination IDnnnnnn mI i I be knoi«n externally as the 
*»C180 error nymber**. It Is a yniqye system-wide code by 
Mhlch any error message can be Identified to the yser* It 
Is alftays printed before the message text on all batch 
listings. It can optionally be Inclyded with messages 
output to an Interactive terminal and Is available to the 
terminal us%f requesting additional error analysis 
assistance via the NOS/VE HELP facility. 

3. 4 .2. 2 £££gi:^lufflij£iis.l&.ifigi 

When error symmarles are listed on a fllej log messages 
should be Issued to both the system and user log according 
to the folloMlng ryl es and formats: 



3-38 
CYBER 180 Sfsttui Interface Standard 

86#02/04 

3,0 OUTI»yT 

3»4«2«2 Brf<if Summaries In logs 

System «nti User Los 

n fatal errors Cin %1 

User Log Only 

n warning or trivial errors CJn xl 

n ny«l3er of errors 

X Is ttie name of the ffiodule^ progranif sy&routlne 

tiiat contains the errors* 

Error suisinaries should only be used when it Is 
Inconvenient to provide a description of an actyal error* 

Cat astropl)! c errors are not lncly<ied t^ecause tiey slioMld 
at nays rtsylt In a log aiessage Indicating tf^e catastrophic 
error* Tlie errcr counts shoyld be Issued to the log even 
If the EL Cerror level) parajaeter exclydes them fro« the 
listing* 

3*4.2*3 £i£2SJiJ.Ml2£iliCS 

Error messages represent a tery iiBportant* though often 
nagiectedf Interface hetnaen software and usetm Proper 
attention to prodycing poilte» corrects and clear error 
messages can do a lot tonard liaprovlng the overall 
usability of the systeii* The foiloiilng conventions should 
be ysed In deflrlng error message text* 

• Hessages should be polite and courteous* ycrds such 
as **lllegal'* should be avoided In favor of Mords like 
"incorrect" or "unknown*** Etror laessages shoyld# 
Mhere appropriate^ suggest what the user ou^ht to do 
to correct the error* For ejcainple^ uses 

The line number parameter must be an Integer* 
not: 

II legal I Ine nuipber * 

• Messages must be formatted for 80 character displays* 
Telegraph style Is mucli better than long-winded 
prose* Hoitever# the message irust be descriptive of 
the error* Messages like "Bad Argument** don't say 
enough* 

« Consistent terminology Is eMtreisely Important* For 

system-Nidc terms consult Section 6*0 of the SIS* For 
terminology specific to a products again consistency 
is the Important factor* 
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3«4«2«3 Hess age mr^inu 



Identification roust be provided ultt? variable 

inferiatlon* For exaiaplej 

yse^ 

Fi i€ n fn) not found. 

Variable Ivar) must be scalar* 



nots 



Clfnl not found* 

Variable Cvar) must be scalar* 



Use ending punctyation* It Indicates to tie user tliat 
tt^e message is not continued on tfia next line and mMs 
to tbe readability of the message* 

Hessases sfcculd be oriented toi^ard an Inexperienced or 
casual user sucti tliat tlie iBessage can be understood 
and appropriately responded to ultiout reference to a 
usanyal* 

Abbreviations sl^ould be avoided* Mlienever possible 
I lull t the cl^aracters use4 to alphanyiserlcs plus 
englls^ punctuation* Avoid use of characters that 
appear differently on different devices* COC*s 
64-ctiar acter ASCII subset and lowercase alphanufferlcs 
can be used* 



• Words beginning nitti ••fpyltl" and ••non" are not 
hypiienated. Don't use ••isJ" to Indicate an optional 
plyrai usagei elttter singular or plural Is acceptable* 

• Error laessages should yse uPPer and lotier case as tliey 
are nornial ly used in tiie Engllsfi language* ypper case 
sliould be 4ised to distlngulst^ ^conspyter** nords froin 
normal Engllsli words* For examples 

File FREO not found* Specify Keyword HEW* 

3.5 yiM£.^I4IIlII£i 

Ail products are required to collect and log statistical 
information* 

TNIs section describes Mk%t tbese statistics afe us94 for» 
the NOS/^E Statistics Facility^ MblcH statistics mIII be 
collected by products and uhlcli nil I be collected by tl^e 
0/S and Miien statistics should be logged* 

Because ttse Statistics Facility Is under control of NCS/VE 
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3.0 OUTPyj 

3,5 USAGE STATISTICS 



product d^slgnsrs are re<;yested to convey statistics 

reqylr#raents ar^d plans to the NOS/VE deslfn t«a»« 



3.S,1 PURPOSE OE STATISTICS 



Statistics i03$ed by prodocts isif be ysed for l»lllliig> 
iieasyring reliafellltir^ ffieasyrlns performance^ detsuggins^ 
prodyct planning or soaie other purpose* The yltlraate use 
of tlie data cannot be determined Mhen the product Is toeing 
designed. For examplt^ a statistic such ^s "nuistier of 
source statements coiiiplled**> Khich Is nornally considered 
a perforfliance statistic^ could Just as easily be use4 as 
the basis for charging or billing a user* It's not 
Inconcelyabie that a student could be billed based uP on 
(nufflber of source statements! - C number of coawent lines) 
^ n * Cnuiuber of errors) if this data were available for 
each compile* 

There are three physically different logs for recording 
statistics* They are the accountlngy Job^ and system 
statistics logs. See section 3*2* A particular statistic 
may apply to one or all three of these logs* To prevent 
products froRi having to Issue the same statistic several 
tlmes^ to prevent product designers froi having to decide 
which statistics Mill be used for xhlch purpose^ and to 
provide Installations and users maxiisym control over 
statistics gatierlng> MOS/VE provides a centralized 
Statistics Facility* 



3*5*2 STATISTICS FACILITY 



NOTES This Is preliminary InforiBatlon. The HCS/VE 
ERl should be referenced for a more coispiete 
and up to date specification* The ERS Is the 
control ling document for this product to O/S 
Interface. 

The NOS/VE Statistics Facility is used by Products and the 
0/S to accumulate statistics and nrlte records Into binary 
logs* 



The Statistics Facility 

associates a statistic code from a status record Kith 
a particular table entry 

adds Job and task Identification to the variable data 
If appropriate* Tas^ I dei^tlf Icat ion specifies iihlch 
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3.0 OUTPUT 

3.3.2 STATISTICS FACILITY 

of tk€ possible several asynctirofioys Instances of 
axecytion m I thin a Job tt%e cyrrent statistic l^e longs 
to* 

- roytes the statistic to the appropriate los or logs 
and/or 9^44s it to a spaclflc counter as determined by 
ttie table entry* Coynters can be dysiped to binary 
logs at specific times or events. 

Data passed to ttie Statistics Facility inciyde: 

statistical code - ordinal of this partlcyiar 
statistic. 

~ optional byte string - for pr cdycts this string 
contains product ID^ inodyle identifiers if 
approprlatef and any ottier prodyct or statistic ynlque 
descriptive data. Product ID Is the txo character 
Identifier defined In section 4.1 .1. 

optional coynt fields - to n nuiabers^ the ny^erlc 
part of the statistic. 

Data returned Includes 

Status - boolean Indicating nhether or not the 
previous Statistic Facility request was processed 
correctly. 

The method for assigning statistics ordinals mI 1 1 be 
specified In the ERS. A separate range of numbers nil I 
probably be reserved for users. 

3.S.3 PRODUCT STATISTICS COLLECTED BY NOS/VE 

In generaly the 0/S Is responsible for colleoting Job step 
statistics that can be deterailned external to the prodyct# 
that Is statistics that the 0/S Is capable of determining. 

For each product identified In SIS section 4.1 that Is 
directly Invoked by the user^ e«i«# via comi^and or ms a 
prograoi Initiated task# NOS/VE mIII record resources used 
P^r Invocation. Resources accounted for Include: 

total CP-tlire 

ajaxlfliun? virtual mefror^ used 

fliaxliruns fB6% memory used 
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avarage Mnrklns set size 

- CP-tiflie per Biemory siza ys«<l 
fiyalser of I/O r«<iue$ts 

amount of dtta read/wr I tt en to flies 

Additional data to be coM acted for eacii Invocation of a 
product includts 

origin of job step - batcli coaimand^ terminal coa^and* 
procedyfe file» execyting Jot)* 

type of termination - normal^ prodyct errors tl roe 
limits invalid roeinory re<iuest^ operator drop# etc* A 
recovered condition 6Qes not cayse prodyct termination. 

average Inttractlve response time for interactive 
prodycts - the average elapsed time between Inpyt data 
available and oytpyt data issued to terminal, 

the fact that the product nas Invoked (added to coynt 
of the nymber of separate Invocations)* 

~ number of modyles loaded (Inpyt units for the loader I 

- soyrce languages of modules loaded (added to language 
usage count). 



disk accesses per CP second* 
These same statistics^ resource usage and additional data# 
may be collectec for any user Initiated Job step whether 
it Is a us&t supplied proyran; or a CDC supplied product* 
Statistics for products Mill be Identified by product ID» 
correction letel inforpatlonj and task nuinber acquired 
during loading* 

Task number Identifies iihlch Invocation of product x 
Issued the statistic* Several asynchronous tasks iiiay be 
executing the same product* Statistics for user written 
tasks toay be Identified by primary niodule nanie» task 
number^ and other data gleaned from the file ID* 

Number of Invocations mIM be collected for all prodycts 
both user called and product called service products such 
as Access HethodS;» and all user tasks* It could be 
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collected for all ipodyles on systcai libraries* for 
prodyctsj It represents tlie nymber of tiroes the pro duct 
was invoked over a given tli^e span; for yser prograas It 
represents tfie nuatber of tlises a progran inodule nrltten In 
tangyage x was used over a given tlsie span* T^e tl^e span 
Is installation definable. 

3«5*4 STATISTICS CQUfCTiC 8Y PRODUCTS 

In generals prodycts are responsible for collecting Internal 
statistics that only ttiey can knoii. These statistics provide 
a means of cliaracter Izl ng the «ork ^^tforme^ by a prodycti 
they are ysed for evalyating prodyct performance* Statistics 
to be en^ltted Mte specified In t^e prodyct*s DR« There are 
tKo classes of prodyct generated statistics - Inpyt ynlts 
^nd Internal ysage statistics* 

3.5.4.1 iQiiil;^yoli«Si;iiisMjBS 

This class of statistics 3s concerned with the nynber and 
nature of yser controlled data processed by the product* I 

All prodycts are reiiulred to log number of Input units i 

processed pet Invocation* 

Inpyt units for varloys prodyct types ares } 

a 

Product Type Input Unit S 

s 

Language translators^ sych as Source I 

FTN# C060U CYBIU lines I 

Utilities such as SGRT/HERGE# fm Data records I 

Services such as AA^ Functional I 

re^yests I 

Other meaningfyl Inpyt unit related statistics laust be emitted I 

by products^ M^ere applicable. AO/R specified measyreffient of I 

performance requires generation of sych statistics for certain I 

prodycts* Examples of these other Input statistics ire: I 

Language Translators 

nymber of mcdyles processed 

I 
~ number of source statements 

number of lines consisting solely of blanks 
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i^umber of lines consisting solely of co^wents I 

nymber of scyrce stateasent errors for eacti arror level 
Utilities 

- number of records of each recognizable record type sypported I 
by the product i 

- number of records In error 

Services 

I 
nysjber of fynctlons of each defined type I 

- nysiber of 1 11 egai/l H-forpe<l re^gyests I 

i 
Hany other potentially usefyi Inpyt related statistics are 
possible* Products developers are encoyraged to collect 
additional Input statistics they feel are Morthnhlle* An 
example Is source stateiaent fre^yency^ ]«e*» nyisber of 
each type of source statement encountered* 

3,f .4.2 iQifitoal.Stailsiixs i 

I 

This class of statistics Is concerned ulth Internal foeasyres of I 

the product as QPP0se4 to measures of the Input data* I 

I 
An example of such a statistic iss I 



product options In effect for this execution e.g.^ I 

what control staten^ent parameters nere selected* 

I 
Products are re<;ylred to log major options selected Isych as I 

opt Iniizfitlon level useo t:^ a coaipiler}* Each product Is required I 

to specify i«hl€h options are fsajor* « 

I 
Many additional statistics (such %s Internal errors encountered) I 

?nay be applicable to specific products* Developers are encouraged I 

to collect other statistics they feel are KorthMhIie* • 

3.f.5 mm TO LOG STATISTICS 

The two Issues of concern are: 

Mhen should detailed optional^ statistics be 
accumulated and logged? 

when should subordinate service products such as AA 



3—45 
CYBER 180 Sfstew Interface Standard 

86/02/04 

3.0 OUTPUT 

3«5,5 WHEN TO LOG STATISTICS 

log statistics? 

Aft statistics Miti bm controlled by Instslletlon or yser 
control ted switches. Tl^e statistics Facility i<flil provide 
the mechanlsfli for setting and clearing tliese sultclies* 
Eacfi procedure tf^at Issues diagnostics must clieck ttie 
appropriite sxltcti before calling tlie statistics 
Facility. The sultcties will profetbly exist as an array of 
bits tliat can fee referenced but not changed by yser 
tasks. Tlie HOS/VE ERS *»MI specify the exact for®* 
Sul)ordlnate products and routines mm either Issue 
continuous statistics at product deterisJned intervals or 
events or they may accynul ate and report thee under 
control of the host product. 

For products such as AH and AA Mhose statistics could be 
inaanindfyl fQ§sfii%€ss of the host^ the first approach Is 
acceptable. For example^ statistics could be gathered 
frow file open to file close for each file. Anyone 
Interested In AA statistics for a Job step Kould hait to 
sum up the individual statistics on the log fll^. 

For subordinate products and routines such as the co«Aon 
compiler (modules whose statistics btb not fiieanlngful out 
of contexts a leechanlsii; should be provided to enable the 
host to force out statistics on denand. That ls» tlie host 
must be able to Inform th^ subordlnata that Its i«ork H 
coisplete. If the subordinate actually Issues the 
statistics? the host must provide its product ID to the 
subordinates so that ID can be Included In the 
statistics. If the host actually issues the statist! cy 
the subordinate must return all data and Identifying 
information. Ti^e first wethod Is preferred since the host 
does not need to ^noM Mhlch or hoi« many statistics the 
subordinate is collecting* 

Note that all wethods of statistic reporting re^iulre 
products to recover frcn; catastrophic external an4 
Internal errors. Products roust regain control so that 
ti^ey can output the accumulated statistics. Furthermore? 
since 0/5 logs the reason for terajl nation* products that 
recover from abnormal external conditions must be able to 
let the abort happen after they Issue their statistics so 
that the correct reason for the termination is recorded* 
Products that detect internal errors must be able to 
Indicate that such an error happened when they aborts so 
that "Internai error" Is recorded as the reason for the 
abort. A product may choose to terminate via an abort 
when no product error hzs occurred. 
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4,0 miii3iiiai-c;oyi£iixoi^5 



This section descril^es the operating S3rst«ffi and prodyct 
set convention t^lilch eyst be foi toned by all standard 
software* 

Tha teras "glofetl** as ysed in tills section refers to 
constant and t^pe definitions tt^at are global to several 
prodycts. It dees not mean ♦•global" iilthin a parti cylar 
pr odyct* 



4.1 iiiM£ii«aiiii.ii^i^-iiiiii 



standard systes^ naming conventions are needed for tlie 
folloMing reasons^ 

1* Permit recognition of tlie arigl^ and paybe tbe pyrpose 
of the named entity jyst by Its name* 

2* Prevent duplication of names between different 
prodycts* 

3« Designate citegorles of names that are reserved for 
CDC ysage so that the^ mI 1 1 not be dypllcated by 
ap p 1 1 ca 1 1 o n p ro g r amper s « 

These names otey be declared as entry point namely file 
naiJies^ SCU deck names^ or as nafiies for common system 
entitles such bs Installation options* The common systeai 
entity names must be declared In a form that provides a 
siinple soyrce of availability for yse by any system 
Implementation language^ {CYBIl or assembly) • 



4*1.1 NAMING CONVENTIONS 



The system defined global nanes Mill be generated 
according to the folloiflni convention: 

PPC$XXX 

shares 

?? — Is a 2 character alphanymerlc product 

Identifier or other global identifier for the 
OMner of this symbol* 

C — identifies the class of the name. 
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$ — Is tlie special cliaracter $ 

XXX — 2 or more aipfeanyoier ic characters itlilcli 

dstabilsli ynltyeness Mlthln ttie levels of 
identification descrllsed above. The mmxlmum 
length of this field is determined bf the other 
users of these na«es« inainple: The loader 
determines the aiaxlmysi length of an entry 
points the record inanager the laaMiffiyni length of 
a file name. 



4.1.1.1 ££MMfit.ls3suilfll£S 



AA 
AD 
AL 
AM 
AP 
AV 
BA 
BC 
CC 
CB 
CF 
CG 
CL 
CM 

cs 
cu 
c\/ 

CY 
DA 

D3 
DC 
DO 
DF 
DM 
OP 
DS 

ou 

FS 

FA 

FC 

FD 

FL 

FH 

FM 

(Oout) 

FS 

FT 



Advanced Access method 
Ada 

Assembly Langyage 
Access f^ethod 
API 

Accounting Validation 
Basic AtiM^ss fiiethods 
BASIC /C.^- 

Cofflffion Co mP i I er «odu I es ICC M) 
COBOL 

CYBIl Fcrtatt«r 
Comaion code Generator CCCG) 
Coiiinand Langyege 
C on f I $ ur a 1 1 o n H anagesien t 

Character virtual terminal Screen management 
Concyrrtnt maintenance Utilities 
CYBER Vectorizing Code Generator 
CYBIL 

DCH dy«p Analyzer 
_.JjitjarA4it4-ve Debyg 
Olstrltyted Cosiijsyn I cations 
Data Dictionary 
Distributed Files 
Device Kanageuient 
01 spl ay 

Deadst art /recover;^ 
N05 Duflip Analyser Utility 
Edit Screen 
F1 I e migration Aids 
FORTRAN Compiler 
Format Display 
FORTRAN run time Library 
File Management <in BAH) 
File Management utility 
1 8 use of fM to be resolved by DAP# If there Is a problem) 
File System 
FORTRAN. Global to FC and FL 
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FV 
GS 
HP 

Hy 

IC 
IF 
II 

m 

10 

JF 

Jii 
JS 

m 

IS 
LI 
IL 
IN 
LQ 
iU 
MA 

m 

HI 

m 

m 
m 
m 

NA 

nz 
m 

NP 

oc 

OF 

OS 

PA 

Pg 

Pf 

Ito 

PM 

PP 

PR 

PS 

PT 

PU 

PI 

OF 

QU 

RF 



CDC FORTRAN C Vector izlns ) 

Grtpliics yirtyai terminal Screen panagesient 

Hardi*ari Perforinance analyzer CHPAI 

Help Utll ities 

Interstste Coaffiunication 

Interactive Facility 

Interactive Interface 

Infer® at I en Man ageinen t 

Inpyt/Ciitpyt 

Job Fi le manager 

Job Hanageinent 

Job Stiiepper 

Keypoint Reporting UtHltf 

Logs 

L IS P 

Loa<^er/il brary generator 

Logical Name 

Loai^er 

Link User 

Halntenance Appilaatlon Language for E^ylpffient 

Testing CHALET) 

Marketing Conf^gyrator 

Hath Library 

Memory f^anagement 

Matrl)( Algorithm processor 

Maintenance Services 

Monitor 

MAIL/VE Electronic mall system 

Network 

Network 

Network 

Network 

Object 



Electronic mal I 
Access method 
Ccnf Igyrator 
File Transfer 
Performance 
Code ytl 1 1 ties 



Operator Facility 
Operating System 

Programming Environment 
Permanent File management 
be pliased outf per SIS Dap S4730> 
Program Management 
Peripiieral Processor 
PROLOG 
Product Set 
Per for m an ce Tools 
P¥ Utilities 
PUl 

Queued FI les 
Query Update 
Remote Host Facility Access Mettiods 
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RH Reroote Host facility 

m Res oyrce Hanageisent 

SC Source Code ytlMty 

SO Screen Design Fecit Ity 

SE Set fRanagesient 

SF Statistics Facility 

SH Sort f^erge 

SR Conversion services 

ST Software Tools 

(Current use of ST for Sets will be pliased out In favor of SE) 

SV Shared Varlafeles processor 

SY System 

TO Test Data base 

TM Task Manager 

TU TeriRlnal Utility 

Ty Translater Writing System 

US User Ce«s.^ for "yser" statistics) 

UT Tests 

VC C Compiler 

VX VX/VE - UNIX ijEulator 

IS Zeus 

RA Release Administrator 

Ttsls product Identifier Is usb4 to Identify 
Installation parenieters and procedures associated 
Ml til a J^OS/VE product. 

4.1.1.3 CillESJ£.fif.lai£^ 

The foliOMing list cf Identifiers naming classes Is us^4 
for code Sin6 deck nantlng purposes* 

A — arcfeltectural and design documentation 
8 — design docuisentatlon C Internal to COO. 
Also the three following special blocks: 

CYB$D£FAyLT^HEAF 

DBBSNE.IINE.ENCOUNTERED 

066$N£W^PR0C.ENC0UNTERED 
C — constant 
D — declaration (decks containing types and/or 

constants) 
£ — exception condition nape 
F — file 

H — docuinentatlon (headers^ Inline text) 
I — Inline code or installation/integration 
K — keypoint or ke^^Mord 
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H — fflodyle 

P — proctdwre 

S — sactlon Cstatic data section and/or cowiBon 

block} 
T -- type / . J 

V — variable ^../.v/^ -^^ ^'^'^ 

X — J(l>Ct*d (decks contain! fig procedyres or ^^ ' ^' 

Jwar iables) 

4 « I • 1 • 4 SSl£&i Jl.£llJ£l£i£0 

Tie use of the $ sign In a name Identifies the narae as one 
balongini to CDC* COC users lilll avoid any dupllcaticn 
«lth COC naffles fcy not using tl?e $ In any of tlieir nawes. 

^ . ^~ -- -■ "■ "^ ' 

Soiae pf ograpining languages sucti as FORTRAtI do n©t allo«« 
Imbadded dollar sign characters In their nasses* COC 
supplied procedyres callal^le from these langyages mII ] not 
conforsB to the $ sign rule* 

User global napes follow the rules defined In 
sections 4.1*i-4»l«l«4# except the for»5 of a 
user global name is« 

l>PC#XXX 

Relationship of Cede and Deck naises 

The deck naise nust be the same as the code natte whenever 
possible. In Instances i«here it Is absolutely necessary 
to group types f constants^ etc* In the sa^e deck# then It 
Is alloMabie to use a conglomerate deck name Mhlch is 
different than the coa?ponent code names* 

•'Design Docunientatlon*' Oeck Names (A and B) 

Class A decks are for architectural and design docunentation 
releasabie m^th the code* 

Class B decks are for requirement/design documentation not 
releasable ulth the code (e«g*» Ol^-type sped fi cat I onsy such as 
performance) but rel event to code maintenance* 

A **deslgn documentation" deck has the EXPAND attribute value of 
TRUE or FAISE# depending upon the needs of the product* The content 
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of this deck anti all decks *COPY€d Ijy this deck are Inpyt to the 
processor named In the PROCESSOR field of the SCU deck. The PROCiSSOR 
Is in tlie form of a string which represents the coiasiand hy Miilch the 
processor Is Innoked* Docymentation decks isay not be processed by a 
compiler feyt rather fey a text formatter processor* For Instancej 
docyinentatlon decks wight be processed on the ClTOj then ttit 
PROCESSOR jBlght be TXTCOD£» In the fytyre# docy«jentatlon decks stay be 
processed on the CI 8 by a text processor. 

Docynentatlon decks not to be released to cystoaers nyst be 
Identified <by groypi by the development project to Integration^ 
which itlll redeye sych deoks dyring preparation of SHO release 
tnaterlals. 

^•Coflipl lable" Deck Naiaes (H and Fl 

A *'coppl iable** deck has an EXPAND attrlbyte valye of 
TRUE. The content of this deck and all decks *COPYed by 
this deck are Inpyt to th^g processor nasied In the 
PROCESSOR field of the SCU deck. The PROCESSOR field Is 
In the forns of a string which represents the coniRiand by 
wiilch the processor Is Invoked. Parameters uhl oh are to 
be pMsse4 to tl^e processor^ and Mhlch are nieant to be 
Invariant Csych as optimization levels or debyg letell^ 
fnay be Inclyded In this string. The order In which 
Invariant paranieters are specified Is precisely the order 
In which they are defined for the coniiiiand# e^en thoygh the 
parameters ^rt specified as eqyivalenced parameters. Fife 
references are disalloiied In the processor string. 

H class decks contain a processor defined ''compilation 
ynlt". Examples of sych compilation ynlts ares HOCULE to 
MQOEND for CYBIl, IDENT to £MD for ASSEMBLE* PR06RAH to 
^MO for FORTRAN* etc. Hodyle decks represent the ynl ts 
which are maintained In a Binary Hodyle Replacement 
environment* A ptrent/chlld relationship exists between M 
and P (or V) decks which contain XREFs. To denote this 
associatlonj the name of the parent H deck Is assigned 9iS 
a GROUP attrlbyte of the child P or V deck. Thys> any 
modifications made to the child deck resylts In the 
ability to generate the parent deck by Interrogating the 
GROUP attri bytes of the clil I d deck. Likewise* all decks 
which *COPY the child deck can be generated throygh yse of 
the IMCLUOe.COPYING^DECKS Criteria File directive. The 
name associated with a H class deck Is the same as that 
specified on the MODULE* IDENT* PRGGRAH* etc. statements. 
If a H deck contains code which Is later Boynd Into a 
Modyle of a different name via the BIHO^HODULE sybcomaand 
of CREOL* then the name of this Boynd Modyle Is assigned 
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as a GROUP ittrlbyte of tlis M deck. The naae of a 
corresponding F deck uhlch contains specific CR£QL 
directives associated ^Itti tlie binding of tt^ls module Is 
specified as a GROUP attribute of tills H deck* 

F class decks contain source data mIiIcI^ Is retained as a 
file* or contains processor directives for the processor 
nailed by the processor field* These decks contain* or 
*CQPY decks containing* InforiBitlon necessary for 
establishing progran descriptions* oa^ltting entry points 
from 8oynd Modules* or establishing SCL procedure 
libraries. A typical ¥ deck ©Ight contain CQIL£CT«T£XT 
and AOD^HCDUiE cowhands* and ♦COPY*s to procedyre decks {^ 
decks) which contain the source of procedures to be added 
to a procedyre library* Another yse of F decks Is as a 
container for directives to the Real Hewory Bylldar or 
VIrtyal Henory Linker In Mhlch segisent attributes are 
defined* If a SCL procedure Is to be executed fro« a file 
rather than a procedure library* then the processor type 
of the F deck Is SCL rather than CREOi. The naaie 
associated Mith F decks Is the na»e of this file as It is 
accessed Mhen the processor Is Invoked* or the nanie of the 
resultant file uhlch Is to be created* 

"Hon-coppHabl€« Deck Naffles CC* £* I* K* P* S* T* V) 

A "non-coispl lable" deck Is one ulth the SCy deck EXPAND 
attribute value of FALSE* This type of a deck Is *CQI>Yed 
by "compi iable** decks and assumes any attributes 
associated i«ith the *COPYing deck. 

K class decks contain KEYPQIHT* KEYiCRD* or statistic 
codes* These codes are defined In teruss of a constant 
plus relative offset* and define a set of related data* 
K decks are given a conglomerate naiise uhlch Indicates the 
type of data being described (KEYPOINt* statistic* or 
KSYyORD). 

C class decks contain Constants* Constants are used to 
impose an upper limit on ranges* and provide a starting 
point fron^ Mhich relative offsets are cooiputed* A 
constant is glob a J in nature by virtue of its appearance 
In a C deck* Those constants uhlch define product 
restrictions due to their design leg* OSC$HAX.NAH£.;SIZ£l* 
and those const snts Mhlch represent Installation options 
are the tuo categories of constants ulth jickaglng 
alJects* The fcrmer category of constants are named so as 
to describe the scope of effect upon other products or 
subproducts* Product specific constants should be nained 
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ysing prodyct specific two-cteaf «ct«r Nentlflers. The 
latter category of consttnts are aanse^J with the RA product 
Id8i5tlfl«r to Indicate t*iat the "Release Adialfilstrator" 
assumes oi«nershlp for the ^alue assigned to tlie cor^stant* 
Si^nce source code ullt be unavailable at many sltes# the 
use of cor^stant values isust be avoided* Global cofiitants 
shoyld exist ms one constant P%r deck* The name of the 
deck should be the sanie as that of the constant being 
defined* Ounershlp of a constant Is assumed by the decks 
which *COPY a constant deck* Automated generation of all 
decks affected by a change to a constant deck Is 
accomplished through the IHCLyO£.COPYIH€.OECKS Criteria 
File Directive* 

T and E class Ctcks contain Types and Exception conditions 
respectively* Since Exception conditions ^re typically 
described In terros of a constant plus a relative offsets 
It Is acceptable for a constant declaration to &ppBMt 
Mi thin the E deck* E decks are given a congloiaerate name 
for the condition range* Types may be either fixed or 
adaptable* In such cases ^here a type Is defined In teriRS 
of constant Csuch as an e^ulvalenced ordinal type) then 
the constant value raay be contained in the T deck* T 
decks are named the saine as the prlnary type defined In 
the deck* If the type Is a record* then the naae of the 
deck Is the name of the record defined In the deck* 

R class decks contain code procedures* The content of 
such decks Is the source of non-XDCL*d procedures* SCL 
procedure definitions* or XREE declarations for XOCi'd 
procedures* A SCL procedure definition mIII contain a 
fRQC to RROCEND seouence If the P deck Is used to for« a 
procedure library* othemlse the procedure mIII be defined 
in a F deck* Cede sei^uences nhich sre not bracketed by 
PROC to PROCENO* or a corresponding sequence such bs 
SUBROUTINE and mOp should be contained In I (Inline code) 
class decks* Each external procedura should have an 
accompanying H deck that documents the procedure* 

V class decks contain variable declaratlonsf or the XREF 
to XDCl*d y uiBhIes* A cfil Id/parent relationship exists 
bet»<een a V deck containing an XREF and the corresponding 
n or F deck in i«hlch the variable Is XDCL"d* The naroe of 
the V deck Is the SBme as name of the variable Mhlch Is 
defined In the deck* The name of the parent M or F deck 
Is assigned as a GROUP attribute of the V deck* 

H class decks contain docusnentatlon* such as headers or text 
that fl^ay foe called Into a generated document such as an £RS« 
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CA and 8 class ceclcs mey ba yssd fcr hl§h~level arclil tactyrai 
9n4 design dccuirentaticn* H decks siay bB ysed fQr detailed design 
docya>entition# particularly to suppcrt external procediires*! 

I class decks contain inline code or Integration/instillation 
paraffl^eters* in the case of code# the justification for sycli 
decks Involves perf orjEance# Mhere repeated code cannot fee 
formed Into a I^RQCEOURE dye to the expense incyrred In the 
procedyre call* Cther^lse* EUNCTIQNS or INTRIHSICS nay be 
contained In I decks. Inline text Is text ysed for code 
docymentatlon purposes Nh3ch inty also he called Into a 
ganerated docynent sych as an ERS. 

S class decks contain blocks of related data sych as 
static data of Common Blocks* An aggregate na^e is 
associated Mlth this collection of data ynl ess the text 
data describes a specific entity* In sych cases# the text 
data assypes the same descriptive string as that 
associated iiiltlh the entity It Is describing (eg. 
OSS$MAINfRAH£.fAG£ABlE.H£AP). 

»»N n-co Sip 1 1 ab I €•» Deck Htwes COt X> 

Decks belonging to this category represent packaging 
anofnalles# and shoyld be afolded nhenever possible* 

D class decks ccntain conglomerates of Types and/or 
Constants* Since It Is difflcylt to ascribe laeanlngfyl 
Identity to sych combinations^ the yse of the class 
shoyld be avoided Kfhen possible* It Is advantageoys to 
define paraiseters for procedyres In a D class deck* This 
anomaly exists dye to the natyre of the constrycts 
necessary to define procedure parameters* 

X class decks contain the XOC I definition of procedures or 
variables. The r ecoi^nsended location for the source of 
XDCl^d procedyres or variables Is Mithin a coffipllabie deck 
(H or f class)* Coinblnlny XDCl*d procedures Into a single 
module Is a fynctlon of the CREATE.OBJECT.IIBRARY utHlty 
command BIND^MOOULE. If the XDCfd procedyre Is GATED to 
other prodycts end/ or ysers# then the XDCl'd name Is 
preserved as a resylt of Binding^ otherMlse the nai»e Is 
discarded provided there Is a corresponding XREF at 
binding time* Therefore^ It Is a prodyct*s responsibility 
to CHANGE.MODULE.ATTRIBUTES of the Bound Module to OMIT 
names Mithin Boynd (or Unboy nd) modules which are not to 
be external Ized by the prodyct* It Is recognized that 
being able to combine several XDCL'd procedyres and/or 
variables Into a single compilation unit can provide 
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additional debug capabilities provided Wf a oOmpMer* It 
Is for dtbuf purposes that X class de€ks exist* 

4.1 a.T i£u«isay£.iiii3ii£-MiniUM£i 

Critical to the structure of the product's source llbrarlesf and 
to the efficiency of the source maintenance proce<liire$# Is the 
association of SCO •'group names'* Kith aach deck on the Hbrarir* 
These groups p«> be used to roanlpylate ••blocks" or "sroups* of 
decks^ such mm all decks In a Job t^iaplate or system core library^ 
fair I y easi ly* 

The different types of groups are Identified by the conventions 
used to naaie tl^e«« Except for the '•processor*' and "generic* groups 
(described belOM}# ttse format of all gr<i^P naaes Iss 

xxy$aaaaaa 

^here 'XX* Is tie product Identifier* ••aaaaaa*' Is a descriptive naaie 
for the particular group* and '•y" Is one of the following: 

S Specifies a ••Source^* groupf I.e. a subdivision o^ the 

source library into component ilbrarles* Several 
examples of groups of this type are* 

ossSprogr aro.l nterf ace tosf $pr ograw.l nterf ace) 

fcs$front.end 

cbs$cobo I. source 

F Specifies a ••destination fUs'^ group (l*e* a file onto 

i^hich a deck Is to be placed after processing )• Several 
exainples of groups of this type are^ 

aaf $440^1 ibrary 
osfSflionI tor 
osfSobJect.ccde.ytl I I ties 

G Specifies a •'Group'** l«e» a collection of decks that 

have been decided Mould be yseful to be able to refer to 
en masse* Several exatiples of groups of this type are* 

cbgSpfccedure.co^ia on. decks 
cbgSrun.tlffle.procedures 
fci$br ldge_(nodules 

NOTE: All decks on the source library Mhlch belong In the library 
psf$external.interftce.source should be associated Mith the group 
name "psf Sexternal. Interface. source**. Keypoint decks and error 
codes should also belong to this group* 
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Host ottier group nanes kMI follo*« tU% conventions dsscrlbeil In 

the prtvloys t«ict for the product source lll^rarles* Hoi«€ver# there 

are tuo trasses of groyps for nl^ich tills is Inappropriate: 
"processor*' groyps and "generic* groups* 

A **processor** iroyp mI H ^e given the sape nane ms the 
corresponding processor^ «•§. the grcyp name for decks to foe 
compiled fey CYBIL *«HI fee ••CYBIL*'. Otfeer processor groyp naaes area 



assemble 
f ortran 
C0I20I 

Pp.ccwpass 
cp.coiBpass 
cybl l.cc 


















Note that some 
side of the raachi 


of 
ne • 


these 


mast 


Qbw 


lousi 


y 


l^e 


processed 



on the HQ% 



A **generl€** groyp Is used In those cases Miiere knowing the 

processor for a deck Is Insufficient for somB purpose* The generic 

groups that have been Identified and are re^ylred# If applicable^ 
are: 

common 

P r ogr am.descr I pt I ons 

mess age. tempi ates 

scl.procedures 

c deprocedures 

scu.se feet longer iter la 

bul Id.procs 

deleted.decks 

All decks Mhlch are called by other decks Mill belong to the 
group **co])iii!on'*. lihen a deck needs to be deleted^ It should belong 
to a group "deleted decks". At this point In time* the deck Is not 
real iy deleted^ so the build procedure fnust be specifically 
excluding this deck until someone In Integration can physically 
delete the deck* This kIII only be done between releases to Insure 
our ability to back up to a previous level* 

Some of these generic groups overlap to some extent Mith the 
processor groups* 

A deck flsay have up to Z53 group naoies associated Mith It* At 
this point In tinier a group cannot be associated to another group* 
A OAP has been written to allon this capability* For the time 
belng> Issue the change.deck SCU conipand to establish ail deck to 
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group associations* 

4. 1,2 RESERVED FILE NAMES 

Th€ foliOMlng files Mill have special yses* 

INPUT is ttiat portion of the primary Input file tj^at 
foHoMs tht System coinmanil statements* 

OUTPUT is the primer ^ output file and contains i copy of 
tfie Joto dayflie at the end iihen printed* 

For Interactive jobs# the terminal Is assuf^ed to be bQth 
INPUT and OUTPyi* 

4*1.3 DATE AND TIHE 

While NGS/VE provides date and tipe data In several 
forpatsf products are restricted to using one forraat 
unless language standards dictate otherMlse. The fcriiat 
to be used Is t^e Installation defined default forwat- 

For fixed position listing and file formats* date and tl«e 
fields ipust be large enough to accoemodate the longest 
forass returned fcy the G/S. 

This section Identifies capabilities products must provide 
to support users Interfacing the system froro Interactive 
terialnals* 

Products support different levels of Interactive ysage. 
Therefore a product does not necessarily support all of 
the capalsl I Itles described beloiii. For exaisple* products 
that typically perform batch functions I e.g. compile 
FORTRAN source) do not provide the saise level of 
Interactive capability as one that typically perforns an 
Interactive function (e.g. query a file). 
Hany of the capabilities are provided by the operating 
syster^ and therefore are available to all terininal users 
Independent of the prograiii/appl Icat ion being used. 

Specific Interactive capabilities to be provided by C180 
products Bte described beioii. A Hey Is used to Indicate 
i«h I ch products must Include design and Implefflentatlon of 
the capabilities. The ke^/s area 

A - It Is the responsibility of all products to support 
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tlie capabilities marked Mitli the A kei* 

- Tills key notes tlie terialnal capatsllltles supported In 

ttie IropleiseJBtatlon of the operating system* Tliese are 
available uith afl Interaotlve usage and btb provided 
bys 

« Job Hanageffient 

• He ss a 3 e £ e ner a tor 
File Routing 

« Basic Access Hethod 

• Transaction Execytlve 

• lletMork/CoffiipynJcatlons Access Hethod 

1 - Tt^ls key notes tl?e tern^lnal capabilities supported by 

"Interactive prodycts**. Tbese prograais norsially carry 
on a dialcgye Mith a terminal user to obtain feedback 
and dynainically direct processing* Tbey Inolydes 

Job Hanageaient 

Hess age Generator 

File Routing 

HUP Utility 

Transaction Executive 

BASIC 

Af>l 

OS ytll I ties 

Qyery/Upcate 

Report Writer 

rm 

Interactive Debuggers 

SQRT/HERGE 

SCU 

Editors 

Conversion Utiilties 



4.2.1 INTERACTIVE OUTPUT 



4.2.1.1 ^&a%t3i 
a) 



Tiie page Mldth and length at an oytput device varies 
not only by device type> but also by t^e size of paper 
being ysed in ttie device. The yser must be able to 
Indicate the operational page Midth and page lengtti of 
the outpyt device. Defaults that correspond to the 
teriPinai characteristics are supported* 
-0- 



b) 



lines of deta that exceed the outpyt device page itldth 
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must ba delivered mlttmut loss of data* Data that 
liould !>€ oytput beyond tha right si da of tlie page must 
ba foldad onto a sacoi^d or sycctssiva II oe Crafarence 
section 3*3.1.5). 
-0- 

c} The us^T must be abia to fiava avert outpyt line 

formatted so as not to exceed the oytpyt devioe page 
i^idtli provided the output device page Midth is not 
less than 80 characters* As a siinlffium^ the usbt must 
be able to specify that output lie foroiatted for page 
Mldths of 80 or 132 print positions {reference 
section 3. 3.1 •41* 
-0- 

d) Any output that mzy go to an ASCII se<iuential file may 
Instead go to a terminai* 

-0- 

e) An:^ output i^ay contain a carriage control character 
(reference section 3.3.1. 3)* 

-0« 

f) The carriage control character will direct printing of 
an output file and i«lll not appear kn the print output* 

-0- 



4.2.1.2 MS5S.aiS& 



a) Hesseges inust be courteous* V^ords such as *'ll legal** 
should be avoided In favor of words like '•Incorrect** 
or **unknown**. Error messages laustj where appropr I ate# 
suggest what the user ought to do to correct the error- 

-A- 

b) Messages isust be formiitted for narrow listings* 
~A- 

c) Messages must be meaningful such that an inexperienced 
or casual usbt Is able to understand the i^essage and 
respond appropriately without reference to a manual* 
-A- 

d) Any message longer than 20 characters must have an 
alternate brief counterpart* 

-A- 

e) A user must be able to select either a brief or long 
foris of a message* When using the brief form of 
message^ the user should be able to request that the 
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last message be repeated in its long fora* 

-0- 

f) Messages seii citing Input Cpronsptsl shoyld alMajrs be 
used to indicate that the user Is expected to syppfy 
inpyt. 

-I- 

g) Prompts should appear on the same line as the input 
lihenevsr physical i:y possible* 

-I- 



4,2,1*3 Li&tlajs 



a) Pages of output th«t are longer than the output device 
page length must be d^sllvered nithout loss of data* 
Data that exceeds the pm^ length !Rust he continued 
onto a second or successive page* 

b) Pages of output must not he del ivered to a 
non-hardcopy output device so fast as to ovemrlte any 
previous output hefor^ the us^r can read It if a «alt 
option has been selected by the terielnal user* 

c) The user should be able to have heading Information 
repeated on the second and successive terirlnal pages 
of a listing* Mhen display space Is limited and the 
Information band yidth Is Iomj the user might choose 
to not use space to display repetitive headings and be 
able to see roore data* Mhtre the listing consists of 
«?8ny columns that are hard to dif f erenti atej the user 
might choose to have headings repeated on every page* 
This capability requires that^ i) Page Header text be 
Identified so It can be discarded* and 2) Title text 
be Identified so It can be replicated* 

-I- 

d) yhen Initiating a function the user must be able to 
select alternate amounts of detail to be Included In 
the listing* By selecting $ess detallf the user ought 
to be able to have more Items displayed on each p%9Bf 
and not Just get less Information per page* 

-A- 
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4.2.2 INTERACTIVE INI>yT 

Tfnese standards sypplemant sect I op 2«3* 
4.2.2.1 ££Qt£ai 

a) User discovered typing errors layst be correctable by 
backspacing and retfpJnd* 

b) Tfie user must be able to cancel tl^e inpyt line being 
t^ped at any point before Inpyt completion Is 
indicated. 

-0- 



c) 



d) 



e) 



f) 



Q) 



h) 



No extraneous blanks nl 1 1 be appended to the end cf 
the yser defined Inpyt data for padding. Application 
of tills ryle Is only reqyired If alloiied Mithin a 
prodyct*s standard. 

-A- 

No user typed trailing blanks mIII be deleted froe the 
Inpyt data* The application of this rule Is only 
required If allowed iNithln a prodyct*s standards* 
-A- 



Any Input that 
may Instead be 
that fl le. 

-A- 



supp I led 



f row 
by a 



an ASCII 
terminal 



sei|uentla4 file 
connected as 



A single Input pay consist of {ncre then one line. A 
proiRpt may el Iom liultlple lines of Input in response* 
An input collection ipode may be Implemented In this 
manner. 

Operations retiulrlng only a feii parameters should not 
require more than a single Input* The user may enter 
all parameters for a directive or all directives for a 
single system level command es a single Input In order 
to reduce the number of Interactions and the time to 
complete the directive or command. 
-0- 

The yser must be able to use the standard 
abbreviations for command names> directives and 
parameter Identifiers In or4ef to reduce typing. 

-A- 
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n After inpyt of a command of dlrtctlv« l^as been 

coippleted:» Sncosiplete input stioyiid not be treated as 
an erroff but sJioold cayse further prompting for tlie 
missing parameters* 



-I- 
4.2.2.2 IMmI^UUmQU^&S. 



n) Errors in inpyt i«ill bB diagnosed li^medl ateijr 
following the offending Input line. 

b) Diagnosed ipput error^i myst be correctable i^lthoyt 
"exltlns" tlie dialogue with tlie program. 

-I- 

c) Mhere possible allow diagnosed Input errors to be 
corrected wlti^out re-entering ttse entire line. 

-I- 

d) Any Inp^t diagnosed to the ternilnal ffiust be 
correctable bf ter^intl Input Iffi^edlately folloKing 
the diagnostic nhettier or not the original Input was 
free the terinlngi (see 4»2«3«1) • After receiving the 
corrected Input froro the terminal input nil I revert to 
the prill an source. 

-I- 



4.2.3 CONTROt 
4.2.3.1 Ci20a££il^il^ 



a) The user must be able to have his terminal connected 
MS an ASCII sequential input file ano an ASCII 
se^iuantlal output file for any progras!. 

-A- 

b) The user must be able to suppress the verification 
listing of Input i«hen the Input source and the output 
destination are both the tennlnai. 

-A- 

c) Products that alloM input directives from a file other 
than INPUT fi!ust allow the user to have Input 
directives frois a source other than the teriEilnal 
ilsted for verification at the terffllnal. 

-A- 

d) Products that allow Input directives from a file other 
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tiian INPUT ^ust a Mom ttie ystr to liaye Inpyt 
dirtctlves from a source otiier than tt^e t«rffllfial 
diagnosed to tlie terminal* 

e) The yser should be Bbi% to logical If disconnect tlie 
terinlnel frois en execyting progress iilthoyt ciysing ttie 
program to be syspenoed* Tt^e program shoyl d contlnye 
execution Bn4 the yser shoyld be able to 
sipultaneoysl y enter other coisffiends (Inciyding 
ixecytion of other pro§rai»s)« 
-0- 

4 • 2 « 3 • 2 lOtSmiyeiS. JiIll-.£fi£QS£tli3E.M&li&S 

a) The yser myst have a method for gaining control over a 
program In execytlon. This Is knoitn as an Interrypt* 

-0- 

b) An Interrypted program mNI not be aborted as a resylt 
of the Interrypt. 

-0- 

c) For a program written to execyte In an Interactive 
envlroniient* an Interrypt isyst cayse the program to 
enter a knoiin state* This state Mill normal If be one 
that solicits directives or comnands from the tertelnal* 
-I- 

d) For a program written to execyte In a batch 
environment* an Interrypt myst cause the prograa to be 
sysp ended In sych a manner as to be rest art able during 
the seme terminal session* Control Is retyrned to the 
ccfiipand langyage Interpreter* 

-0- 

e) A connection break is often caused by a comsiynl cation 
line fallyre* A connection break myst not cayse the 
terminal session to be aborted^ but must cayse it to 
be suspended In such a manner as to be restartabie 
when the terminal user can again get connected* 

-0- 

f) A us^f must be able to restart a suspended progras* 

-0- 

g) A user must be able tc terminate a suspended program 
without first restarting It* 

-0- 



4-19 
CYBER 180 S:yste« Interface Standard 

86/02/04 

4»0 SYSTEHyiOi COH¥£NTIONS 

4.2«3.2 Interrupts and Connection 8re«l<5 



l»3 A ptogrMm nrjtten to #xecyte in an Interactive 

envlroninent rr;yst accept a termination directiire in tlie 
state entered as a result of an interrupt* This 
directive must be ttie sane as tlie corresponding sjsten 
coiapand to terailnate m suspended prograffl* 
-I- 

I) Any incoRiplete terwlnai Inpyt re^iuest frora a prograw 
that Is siispended should be reissued (with the proper 
pronipt) Mhen the program Is restarted* 
-I- 

J) The tenslnal user must be able to Interrupt the output 
being delivered to the terminal and cause the 
remainder of the output to not be delivered to the 
terminal until the next prompt* 
-0- 



4*2*3.3 Siatis 



a) The terffilnsi user must be able to solicit a report to 
deterfislne the process of a prograci^ ulthout causing a 
change In the state of the prosraffl* 

-0- 

b) Progress reports niust Indicate the functlonai progress 
of the profirap* For exatiiples 

"compiling prograi SAM.*." 

"coiBpillng subroutine TOM..*" 

••preparlrg global cross-reference..." 

-I- 

c) The terminal usbt must be able to solicit a report to 
deterfliine the system environment Mlthln i<ihlch a 
prograin Is running without causing a change In the 
state of the prograni* An Installation option to 
disable this must be provided. 

-0- 

d) The system environment report must indicate (possibly 
Indirectly) the response time the terminal user can 
expect to experience. This might be by Indicating the 
length of snap-out <iueyes> the number of Interactive 
usefss etc. An installation option to disable this 
must be provided. 
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-0- 

t) Tli€ termlntl user myst b& abit to si^llcit a report of 
ttie state of Its prograin ulti^oyt caysing a ciiange In 
tlia prograai's statt. An Installation option to 
disable tils myst be provided* 
-0- 

f) The proifsfli state report myst Indicate the rate at 
which the yser's program Is progressing relative to 
real time* and the Iwipadi ment to progress. For 
example^ 

^•14323313 - 2.54 CP seconds Snapped Qyt** 

".14324340 - f.72 CP seconds Rynnlng" 

•••14327M0 - 6.21 C? seconds finished'* 

Possible states shoyld recognize the points of delay 
in the systeiij these ral ght be Paging* Swap-cyt^ 
yaltlng for terminal Input* etc. 
-0- 

g) The terminal ^s^t must be able to define terminal 
attributes to be associated Mith an interactive 
session (e.g.* backspace character* echo mo4e» screen 
size). The tertnlnal user must be able to display the 
terminal attributes currently in effect for a temlnai* 
-0- 



4.2.3.4 Mfiie 

a) The terfl^lnal user should always be able to get a 

reasonable response to the Input H£iP. The response 
shoyld Identify the user's alternatives and possible 
correct Inpyt. As a directive* HELP shoyld Indicate 
Mhat directives are able to be ysed at that point* 
The user should be able to proceed after the response 
to a HELP Inpyt as If the Interaction had never taken 
place. 

4.2.4 PRODUCT SET RUN TIHE CQHHANOS 
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4.2.4.1 £iyii.afisl.5I0£aits£al 

PAUSE n Mfi FORTRAN) and STOP literal CJn COBOL) ar« very 
similar. Tfiey sliouid be processed in tlie SBmm naf. 

a. Tiia igassaga PAUSE text Miil tB displafed on tb% 

opsratof's terflsinal or console. TeKt is n or iltertlj* 
and Is a inaMiipyfli size of 5B ofiaraoters. for b&tch 
Jobsj tlie operator is t^a prim^ff system operator. An 
QfP$S£NO TO OPERATOR with an OPERATOR 10 of »SYST£H 
OPERATOR* Is execyted to send the pessase. For 
Interactive jobs# an AHPSPUT NEXT re^iuest referencing 
the file OUTPUT Is execyted to send the wessage. This 
Mill resylt In a ff^essage on the terminal* 

t>. In hatch* an OFPSRECEIVE FROM OPERATOR with the WAIT 
parameter Mn4 the same id as Mbm^ Is execyted to 
syspend the job and lial t for the typein froi^ the 
system operator. The operator kIII respond mI th a 
REPLY ACTION coBiiand. In interactive wode* an 
AHPSGET NEXT re^iyest on the file INPUT is execyted 
Ithis J«ay not be legal* another connected file «ay 
have to be ysed). In either case* the data Is throun 
aifiay and the Job Is contlnyed. 

4.2.4.2 4££££I-£EOI3.£OMSii£ 

The ACCEI»T FROM CONSOLE tin COBOL) shoyld be processed In 
exactly the same iiay as STOP literal {4.2-4.1}* Text 
Moy Id be the data from a prevloysly execyted DISPLAY UPON 
CONSOLE yiTH NC ADVANCING or the message 'ENTER COBOL 
INPUT VIA REPLY ACTION* If there was no DISPLAY. 
Interaction Is >«l th the system operator only. (If 
messages sent via QFPSSEND TO OPERATOR also appeared on 
the terminal* It coy Id cayse confyslon for the terminal 
operator* ) 

4.3 IMSI4iLAIifiti«£i£AI§£IfBi 

HOS/VE mill permit modification of ell system paraifieters 
dynainlcally dyring system execytlcn* The tens 
**l nstal latl on par ai^eter*** as ysed In the classical CDC 
sense* Is not val Id for NOS/VE. 

System pareineters faM Into the follonlng general 
categorl es: 

Hardware characteristics (e.g.* # of CPU*s* type of 
CPU) 
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m System and product defaylts re«i«^ default tape 
density) 

• Account ins parameters 

Limits paraifieters Ce«g«9 siaxieyn EL) 

• Tiling paraff^eters 

System parameter defaults can be set at ttie foi lotting 
tJaies: 

• Compile tiire (compilation at COO 

Build time Ideadstart tape l}yltd at user site! 

• Deadstart time Ivia operator type-In) 

These parameters may be tested dynawl sally and action 
taken accordingly* The product set will re^^ulre no 
paranseter specif i atlon> and mIII dynamically test system 
parameters during execution via requests to HOS/VE* 

The folloulng table Indicates tl^c pirmitted range of 
system parameter control for tfie product set and operating 
system* An X indicates that tl^e option Is allo^ed^ and a 
bliank entry Indicates tl^at the option Is not ailoMed* Any 
e)cceptlon must liate tti^e escpllclt approval of AD£C» 
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4.0 SYSTEHMIOi CONVENTIONS 
4,3 INSTALLATION PARAflETERS 



•♦ +■ — -—«. ♦«^«— — + 



4,3,1 G1N€RAL GUIDELINES 

As a saneral ryie» ttie number of system parameters should 
be kept to an tfesolyte minimumm This niMI ffllnlmize the 
additional testing Imposed by these options and mI i I 
reduce the number of ••different* versions In the flel#» 

A flr^n re^ylreffitnt on both the operating s^rsteii and the 
product set |s that no re<20ffipliatlon at a user site i«lil 
ever be re<iyired to Install the software* ThJs Is a 
re^u3re«snt of binary release* 

4*3.2 LIST 01= FRQOyCT SET PARAMCTERS 

The foiloying system paranieters usay b€ tested dynanioally 
by the product set via requests to NOS/VE Clnclydlng 
networking) s 

type of CFU 

• OS naiBe and version 

• line lildth or screen Nidth 

• terffllnal type 

• screen length or page length 

• pr Int I Ines I Iml t 

4.4 £g£Q£.£aQ£iSSlM 

The purpose of this section Is to describe the conventions 
and responsibi 9 Itles of processing different error 
conditions* 

4*4*1 STATUS VARIABLE 

Alii coffipand and procedure interfaces to the system that 
are visible to the end user must have a status variable as 
a parameter* The status variable Is us&4 to convey the 
result of the comaand or procedure and# In case of errors 
provide Information explaining what went wrong* 

For coamands^ the status {parameter should always be 
optional* When It Is quoted by a yser# the assymptlon Is 
that the variable will be tested subsequently In the 
GommBnti stream and some appropriate action taken* 
Therefor e> the conditions returned to the user should only 
convey Information the user Is likely to understand* 

For proce duress the status parameter Is required* Again 
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4.0 SYSTf^yiDi CON¥£NTIOHS 
4.4,1 STATUS VARIABLE 

the conditions retyrned shoyld be as ynderstar^dabl^ to tlie 
user as possible. Ttils Is particyl ar i^ important mhen 
t^ere MfQ myltlpia procedyr® calls m%de nithln our 
softKiare as ttia result of a single call by a user 
procedure* Eiipliasis stiould be pieced on Improving tfie 
status returned to tlie user rattier tlian blindly passing 
back obscure status from the deptJis of the SFStea. 

Detailed forfl^ats of tlie status variable are available In 

the NQS/VE ERS, 

4.4.2 ERROR TERHINATIQH 

There are a nuaber of errors that can occur In a product* 
some of mhich can be detected and some of Mhlcli can*t» 
This section deals witta the processing to be perforaied 
when detectable ergots occur. 

First of ali> the product should trt to detect as many 
errors as gracefullj^ as possible. This means that 
Internal software tests sfiould be used to detect errors as 
well as using the condition handlini facilities of the 
operating s^stein to receive control In the event of a 
system or hardware detected error* The product cannot 
simply reiy on the standard operating system abort 
processing* 

When an error Is detected^ the product should provide bs 
much of tlie following error localization Information ms 
possible. Some of the information wl i I not be applicable 
to all products* 

Type of error termination (standard system Messages 
should be used for this message). 

. full traceback of the call sequence to the Procedure 
containing the error* This wili be by procedure name 
and line number or relative address depending upon the 
amount of traceback/debug information released with 
the product* 

. Information regarding the user data being processed. 
For a compiler* this might be the procedure name and 
line number currently being processed. For a utility 
or data management product* It might be the current 
record. 

. Optional duups of useful internal tables. 

The above Information should only be logged for error 
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4.0 SYST€HMIO£ CQNViNTIONS 
4.4,2 ERROR TERMINATION 



tar nl nations t^at are probabkw caysad by product fttii lira. 
It slioyid not te ioggad for conditions suoti as tima il^lt 
or operator drop Mhlcli are clearly not product arrors* 

4.4.3 INTERACTIVE ERROR PROCESSING 

Thjs section supplaiRants taction 4. 2^ "Interactive 
Procassins". 

In considering this topic it Is necassarf to dlstlnsylsh 
bat^aen error i^assaies and diagnostics. These tariis are 
difficyit to define precisely but ^re Intuitively distinct 
nonathalass* An error message is generally a syAoiary of a 
comiaandi In an Interactive environment It wants to be 
displayed at t^a terminal so the us%r can find out Mhat 
happened* Diagnostics ar^ generally a part of a larger 
Mhole Ce.g.# list able oytpytl uhlch dye to their volyne 
only want to be selectively displayed* 
An eKafliple Is a compiler mhlch provides a single error 
message telling hCM many errors occurred during 
cojiipi I atlon Bn4 produces m diagnostic for each compilation 
error* 

4. 4. 3.1 gttHL^MM&MStS 

a. Ail error messages should be issuen via the standard 
message generator. T^e message generator mIII 
deterinine iihether the message should go to the 
terminal or the log» etc. 

b. flessages must be courteous. People tend to react In a 
siore emotlcnal fashion nhen using a computer 
Interactively than Mhen using it In a batch mode, 
yords such as *'iliegai*' should be avoided In favor of 
words like •*! ncorrect** or "unknoiin*. Error messages 
should eipiain to the users what they did wrong and# 
If possible^ ho^ to correct It. 

c. Messages must be ir^eanlngfui such that an inexperienced 
or casual user is able to understand the messages and 
respond appropriately without reference to a taanual. 

d. Any message longar than twenty characters must have an 
alternate brief counterpart* The user must b« able to 
select either the brief or the long forin of the 
message * 
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4»4«3«2 Diagnostics 



4.4,3*2 MtiOSSiifiS 



a) Polfits b and c# ab<^va also apply to diagnostics* 

OJ agnostics sf^ould explain the problem fro® the yser*s 
perspective rather than the pro§raw«s« For e^aiaples 

♦•CoMBia fliissins aft^r third paraaieter** 

instead of 

••QVpPARSfPR detected iiieiti syntax". 

b) klhile diagnostics are not typically displayed at a 
terailnai by defaylt» ttiey are looked at by Interactive 
users* This roust be considered when defining tlie 
location of the diagnostics In the listing^ 
Identifying tlie diagnostics tilth a liark that Is 
ynlqyely detectable with a text editor* etc* 



4»4«3.3 iQiyt.MllfQfiSiS 



This section applies to all Input that can reasonably be 
expected to cope from a terminal (e.g«f co)»mand ytlllty 
syb commands ) • 

a* Brrofs In Input mIII be diagnosed Iflswedlately 
fo I lowing the Incorrect Input. 

b. Diagnosed Inpyt errors »ust b€ correctable Mltho^t 
exiting the dialogue Mith the program. 

c« Diagnosed Input errors ^ay be corrected i#ithoyt 
reentering the entire line. 

<f« Any Input diagnosed to the teriPlnal must be 

correctable by terminal input immediately following 
the diagnostic iihether or not the original Input was 
from the terminal. 



4.4.4 BATCH ERROR PROCESSiNS 

4.4 .4 .1 £i:tat-l3fissiflai 



Batch error messages should foilo*i exactly the same 
guidelines as interactive particularly the usage of the 
message generator* 
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4 •4*4. 2 Icaiii-OllSOfiSli 

Tilt kind of ys«r interaction that Is desirable In 
interactive isode Is of course Inappropriate in thatch 
mode. Empiiasis shouid be placed on detecting as laanf real 
errors as possible even after a fatal error tias occyrred# 
The key word k%iB Is ••reaJ*j prodycing a large nyaber of 
eKtraneoiis error aiessages or diagnostics nil I yltlmatelf 
lead to people only correcting one problem at a tine. 

4.4.5 TRANSACTIOM ERROR fROC€S$IN€ 

This section ylll be added Mhen mere design on the 
transaction facility has occyrred* 

4.4.6 RESTART 

This section nIII be added Mhen more design on the systeiR 
restart capabilitJes has occyrred. 

4.5.1 HARDWARE OPERATION 

This section describes software conventions which laust be 
folloned for the liardware to fynctlon In a predictable 
wanner. 

4.S.1.1 iQt&tiQUh^Mutis^ 

Convention* Locate all Interlock itords In cache bypMss 
segments. 

Special system Instructions are provided In the CPU and 
the lOU to Interlock multiple processors/IQU. In generals 
these fynctlon by exchanging the contents of a register 
and a word In lemory. Fol losing this exchange the 
register niay be Investigated to determine whether th« lock 
has been set. For exampi^y a zero Mord In «ieniory can be 
selected to inean **no lock*S then by exchanging a non-zero 
register the lock nil I have been set If a zero valye Is 
retyrned. It is Imperative that sych Interlock Mords be 
unlqye. To gyarantee this they are placed in cache bypass 
segi^ents. Notice that the Instruct Ions Mhlch are designed 
to test and set locks automatically bypass cache. 
Problems arise Nhen the interlock nords are accessed by 
other Instructions sych as loads. 
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4.5.1.2 Pre~seri al liati on of Ci«ar Lock 

Conwentlofis Bafcre claaring a single bit lock Cwla a Store 
Bit Instfyctlon) first set the lock by a lest 
and Set Bit Instruct Ion* 
Care isyst be taken whenever an Interlock word Is set or 
da and to pre~serial Ize the operation* This is done to 
ensyre that* In the event that memory references arm being 
satisfied out of se«iyence# al I outstanding aieicory 
references are coispleted before changing the lock* In 
pr actlce> CYBER 180 systems designed to date ali«afs 
satisfy aemory references In sequence* However^ this «ay 
not always ise the case* The Instruction which sets a 
single felt lock <Test and Set Bit) performs the necessary 
pre-serl all zat Ion* Honever^ to clear the lock a Store Bit 
CMlth a j^ero operand) pyst be usBd* Since this 
Instruct I on has a general iitlllty It does not 
pr e-serlallze. To compensate* the Test and Set Bit 
Instryction post-ser lallzes* Hence# to ensure a 
pr e-serl allzatlcn of the clear lock* the lock should first 
he set <i«lth a Test and Set Bit Instruction)* then cleared 
by the nejst Instruction. 

4.5.1.3 E£ailiS£.SSSfiOili&0S 

Convention: Registers A0-A4 and XC-Xl shall be r^s%f^e4 
for special functions* 

The CYBER 180 Instructions nsake use of certain registers 
to hold given values* The assignments are as follows* 

AO - Dynamic Space Pointer I DSP) 
Al - Current Stack Frame Pointer CCSF) 
A2 - Pre^flQUS Save Area Pointer <PFA) 
A3 ~ Binding Section Pointer (BSP) 
A4 - Araumtnt List Pointer (ALP) 

These registers hold those values by software conventlont 
but a convention which Is supported by the hardware. 
Hence* It Is very Important that they be supported by all 
software procedures. In particular* Ai and A2 laust ntver 
be altered by Instructions other than Call* Return and Pop. 

In addition to the reservations above* registers XO and XI 
have a special meaning In the hardware. For many 
Instructions* the XO designator Is used to Indicate no 
register* Hence* register XO cannot be used by these 
Instructions* Both XO anci XI are used as fixed utility 
registers for several Instructions. Examples ares 
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1) load/Store multiple and CALL Instructions yse XO 
for a sBVB area descriptor* 

2) AM conpare Instryctlons retyrn a valye to 
Xl-I?lght* as does the HarJ< to Boolean InstrMctlon* 

3) Ti^e 801* Instryctlons optionally ust XO~Rlgtit and 
Xl~l?lgf?t to liold Qp%r%n4 lengths. 

Since these registers &r& us€4 for special purposes^ care 
fflust be e^cerclsed If they are ysed In a general isanner* 



4 • S « 1 . 4 Aiia0iS0i.fit.l£l2l£S«a&il.Mfi££i& 



Conwentloni 



Align certain tables 
bounder les« 



and Mords on specified 



Althoygli CYBER ISO Is notnjnal ly a byte addressabit 
inaclilne# real aewory Is organized Into 64-blt words* 
Consequent! yf the performance of certain operations hBS 
been optimized by placing the operands on tiord 
boundaries* The complete set of data alignaents necessary 
is given belOM^ along itlth a brief description of nhy tlie 
ai I gnment Is required and Hhat will happen when the data 
is not aligned correctly* 



4. §.1.4.1 64-8IT WORD BQUNOARIES 

The foilonlng dcta either must be* 
word boundaries: 



or should be aligned on 



1) Process Segment Table - 



2) Binding Sections 



For performance reasons the 
hardware Indexes Into the 
seginent table at a word 
boundary* The virtual mefpory 
address translation mechanism 
will fill if the segment 
table Is Incorrectly aligned* 

To maximize the reach Into 
the Binding Section by the 
Call Indirect Instruct I on# 
access Is made to a word 
boundary* If the Binding 
Section Is Incorrectly 
aligned* then an A<3i6rBSS 
Specification Error results 
when a Call Indirect Is 
Issued. 
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33 Proctdyre Entry Points - 



4) Defeys List Entries 



5 3 Interlock Words 



63 Stack Frames 



To ffiaxlfflj^e the reach of the 
Call Relative I nstryct tof*# a 
branch Is made to a Mord 
Isoiindary* Since tine 
Instryctlon forces the 
address to a Mord address^ 
results Mill be unpredictable 
If the procedyre target Mas 
not correctly aligned* Note 
that even though Jt Is not 
strictly necessary for 
pr cedyr es called via a 
Binding Section to be nord 
aligned^ difflcyltles could 
still resylt If they are 
not* This Is becayse the 
CYBER 180 Library Generator* 
In the process of *»blndingi*» 
may convert Call Indirect 
Instryctlons to Call Relative 
InstryctI ons* 



- To simplify the hardnare* and 
to optimize per for fiiance nhen 
In debyg mode# the hardware 
accesses debug list entries 
on Mor d bo yn d ar I es • 
Incorrect alignment mIII 
cayse ynpr edict able resylts* 

- Interlock words ysed In 
conjynction «<lth the 
Compare/Stiap operation myst 
be aligned on a Mord 
boyndary* This Is necessary 
for the processor to satisfy 
the non-preemptive 

re<iylr cments of the 
Instryction* Processors 
ytllize the 64-b4t me«ory 
exchange fynctlon In this 
operation* That fynctlon 
operates on a real memory 
Nord* Incorrect allgneent 
Mill yield an Address 
Specification Error* 

- By software convention only* 
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4.0 $YST£HriO€ CONTENTIONS 
4.5.1.4.1 64-BIT WORD BOUNDARIES 



71 Central Hemorf Date 
Accessed by the lOU 



shoyid be 


r4 toun4Mfl%s» 


the i^ardnsre to 


e tha r^ilsters 


ave araa from 


ijoyndar l«s« 


gnmmnt nl II not 


biews sinca tlie 


ws adjusts 


Dfnafflic Spaca 


Mord boun4mry 


ing a stack 



sta€l< frasias 
al I gnad on no 
This analgias 
load and stor 
ha Id In tha s 
data on Mord 
Incorract all 
causa an^ pro 
hardnara a I Ma 
{forces) tlie 
Pointer to a 
fcafora access 
fraae. 



The lOIJ can only reference 
central taemory Mords. Hencet 
It Kould require soaie special 
code In PF's to decode data 
not stored on Kord 
tsoundarles. This Is really a 
pragpatlc software contention 
since a PP has no May to 
specify a central taeisory 
address other than on a moni 
boundary* 



4.5.1.4.2 OTHER BGUHOARIES 



The folloi^lng data ii^ust be aligned on boundaries ot^er 
than 64-blt wore or 8-bit byte. 

(1) Exchange Packages - 123-bit C2 i«ord) Boundaries 

To optimize the performance of the exchange Jumtp on some 
processors^ the hardware addresses tuo words at one tiise. 
Results 14111 be unpredictable If the exchange package Is 
Incorrectly aligned. 

(2) Instructions - Parcel C2-byt€) Boundaries 

Instructions^ uhlch nte either 16-blt or 32-bit 
quantities^ must be aligned on parcel boundaries* 
Failures to do this Mill either result In unpredictable 
behavior^ or an Address Specification mIII be detected. 

fS) Page Table - Page Table Length Boundary 

To ailnlffiize the tinie needed to translate addresses frow 

virtual to real^ the hardware catenates (rather than adds! 
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the Paga Table Addresses IPTA) to the page table Ifidex* 

For tlie catenation to yieid the correct address^ tie 

lo^-order bits of the PTA# as detenlned bf the page table 

lengthf lust be zero. falJyre to structure the fTA In 

this manner mMI cause th€ address translate ^eclianlsfi! to fail 



4.5.2 HARDWARE PERFGRHANCE 



Uhereas the previous section dealt Mitti conventions 
necessary to laake tlie liardMare work correctly* this 
section deals ulth conventions necessary to nake the 
hardiiare «ork efficiently* As sycfe they are not 
pandatory* and In some cases represent merely syggestlons 
as to ho*» to optimize certain fy net Ions. 



4,1.2.1 Lfi£ailtl.13f.E£ffi££Q£fi 



Conyentlons Place all code and all data to be ysed at one 
tl»ie In one place* and keep to a ffilnleyfli the nyaber of 
segiBsnts required to execute a given task. 

The CYSER 180 virtual memory organization provides the 
basis f<3r the systesi security and simplifies the explicit 
organization of a program Into overlaps. Hoi»evdr^ all 
programmers have responsibilities If system throughput Is 
to be optimized* A priiiie responsibility Is to i^alntaln a 
strict locality of reference. Ttiat Is collect all code 
and all dsta tliat Is to be use4 at one time Into 
contiguous pages In one segment Ceach for code and data). 
This has tMO advantagesf It minimizes the MorkIng set (the 
number of pages allocated In real memory at any given 
point of time}* and It al^o minimizes the number of 
entries Mhlch n;yst be made In the buffer memories. By 
minimizing the viorking set the number of concurrent tasks 
Hhlch can be held In real memory is maximized. This* In 
turn* maximizes system througliput. 

Optimizing around the buffer memories represent a slightly 
different problem. These have a finite size and contain 
the most recently used Segment Descriptor Entries and Page 
Table Entries. If a large number of segments are In use 
at one time> or if a large number of pages are In use at 
one time* then the buffer memories Mill be unable to hold 
all the necessary entries and they mill be constantly 
loading new values. The affect will be similar to not 
having them at all and performance mill degrade 
consider abl y. 
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4.5.2.1 Locality of R€f«rer5ce 



Consaqyentlyjr r>ot only sliouid programmers n^aintain a 
locaMty of reference* but tliey stioyld also try to 
localize tlie nuiber of segments ustt^ by a given task* 

Conventions Ai locate A-Reglstars and X-Reglsters fro« ttie 
sinii] nyil^ers on up. 

As a resylt of the special fynctlons for which A0-A4 and 
XO-Xl are ysed# and tlie roethod of saving/restoring 
contisuo4JS registers by tlie CALL/RETURH Instructions* 
register ysage shoyld alMays start mI tli the sfliailest 
possible nyo^ber ftyplcally A5 and X2}* This mIII help to 
fPlnliBlze the nywber of registers *«hlch i»yst be saved 
across procedyre calls. This* In tyrn* Mill optimize 
perfcrwance In this area* 

4.5.3 SECURITY 

This section lists software conventions needed to provide 
a secyre envlroMent at all times* Since a laajor 
objective of tlie CYBER 160 program Is to provide a highly 
secyre system* thtse conventions become mandatory. These 
conventions bt^ closely related to those In Section 2» 
Jyst as they are reciylred to make the hardware operate In 
a correct* predictable lanner* so are these re^ylred to 
guarantee that the secyrlty and protection algorlthiiis 
fynctlon correctly. 

4.f .3.1 ELfi£ti^U££.£j£jgi£l££S 

Convention: 1) Altiays yse ca 1 1 er^s argyment list pointers 

for accessing caller's data. 

21 Always load pointer parameters directly 
Into A-Reglsters - via load A Instryctlons. 

3) Whenever possible avoid moving record 
stryctyres that contain pointers* 

4) Avoid passing pointers between rings 
either way. 

5} Avoid data stryctyres containing direct 
pointers that cross rihgs either way. 

These conventions are mandatory for those procedyre calls 
from one procedure to a second one with more privilege* 
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¥hen a procsdyr« Is callecl by another procedyre^ It 
execytes on betisif of ths cailar. It Is the 
f esponsibl t Itf of the callae to ensure that It does not 
execyte wltli mere privilege than caller* The hardware 
provides the basic security m echini sros* In this case# It 
ensyres that caHee is called fro« ulthln Its call rlf^i 
brackets and that It Is caiied via a Binding Section. It 
may then access code and ilata belonging to or accessible 
by caller* This code and data Is referenced via pointers 
held In A-Reglstersj and the hardi«are performs a rins 
nyaiber vote whenever an A-Reglster Is loaded. This 
mechanise ensures the 3 east prlvllese {highest ring 
nyiaber) Is aluays accorded the user* Homen^rp there nre 
oiany ^&ys this ineclianisffi can he be^pMsse^* The simplest 
method is for eel lee to load a pointer Into an X-Refllster> 
then copy It to an A-I?eglster. If caller places a low 
ring number Czero >*ould do) In the pointer^ then It will 
end yp with caHee's ring nymber In the A-Reglster. That 
Is it will end yp Kith laore prlvllene than that to Mhich 
caller Is entitled. It Is cai lee's responsibility to 
ensure this docs not happen. The onus for laalntalnlns 
secyrlty always fills on the more privileged procedure. 
Hence* the convention. 

EBCDIC data can be divided Into two distinct cl assess 

1. all 8-felt character data (also known as coded dgta* 
including unpacked nynier i c data types); and 

2. Intermixed character and non-character data. 

Sypport for the former (all character) Is provided by the 
operating systerr;* If EBCDIC Is specified on the re<iuest 
card* the tape driver automatically translates to ASCII 
when reading the tape and translates back to EBCDIC Mhen 
writing the tape. 

Support for the Setter (Intermixed character and 
non-char act er)# and for the EBCDIC collating se^^yencet 
var les by products 
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EBCDIC SUPPORT N 

lntermixe4 EBCDIC Inpyt file fi X 

Irjtsrmixed EBCDIC oytpyt flie e X 

EBCDIC collating seimence X XX 

X = support reciy I red at Rl of prodyct 
€ - eventual support dtslrabie 

Sypport of Intefffiixetl Input end output flies «eans use of 
the special C18C Instructions to process ttse folloMing 
"translated*' non-character EBCDIC data t^pess 

• Binary <slsned and unsigned) 

• PBcke4 Decimal (signed and unslgnedl 



^•7 ll£IEiiMI«yS^£I 



The CYI80 keypoint facility pfovldes a aeclianisia to enable 
collection of statistics for perforirance isonltorlng* A 
data reduction softnare package Is airallable to suanarlze 
these statistics based on descriptors contained In a 
ke^polnt descriptor file CKOF). This section dacuwents 
the conventions to be folloned by the operating system and 
product set In the usage of this facility* 



4,7,1 KEYPOINT CLASSES 



five keypoint classes named ENTRY, EXIT> UNUSUAL# OiBUG* 
and DATA are defined for the operating system and Product 
se t « 

ENTRY Every gated procedure plus all wijor 

Internal procedures C those shared across 
functional areas) should contain a 
keypoint of this class* These keypolnts 
should be placed as close as possible to 
the entry to the procedure* 

EXIT Every gated procedure plus all major 

internal procedures (those shBrB4 across 
functional areas! should contain a 
keypoint of this class* These keypolnts 
should be placed ms close as possible to 
the exit from the procedure* 



.>{jtfiit,::^i^ri^'Wii''iw!,-^-mi~j^i>-^iai^''^!iiiifM^ 'ii^ ■1)t^i''"ll"llf'f**yvw'M""ii-" imi m 
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UMUSyAL Everf sityatlon tih} ch is unexpecttd or 

quite uf^ysyil slioyld cofitain a ka^poJnt of 
this class* It is Inttndecl that these 
k eyp i n ts Mould b% en ab i ad at all 1 1^ as « 
The fre*|yency of ancoynter If^g these 
kaypoints should he ran low* The DATA 
kaypoint class Is not alloMad in 
conjunction with a kaypoint of class 
ynysuat • 

DEBUG These keypolnts «cyld tsa for provldlns 

additional trace InforRiation as an assist 
In dahygglng of har(^m^rQ or software 
problems* DiBUG class kaypoints Moyld be 
inost ysefyl In the isore complex areas of 
the system* The priroary use of kaypoints 
in HCS and NOS/Vi yp to this point has 
been for debugging purposes* 

DATA This keypoint class can be used MJtti the 

ENTRY* EXIT# and DEBUG kaypoints for the 
gathering of extra data* All DATA 
keypolnts ancountarad are supplying 
additional data which nil I be associated 
*«lth the last EHTRY# EXIT or DEiUS 
keypoint* Hance> they shoyid fotlon as 
closely as possible after the £HTRY» EXIT* 
or DEBUG keypolnti In particular* there 
should be no Inter van I ng CALL 
Instruction* DATA kaypoints sfiould fee 
used with care since the PM hardware can 
only byffer up 16 keypolnts; keypoint 
c I ys taring can cause i est keypolnts* 

Keypoint Data and Identification: 

Upon syccassful execution each keypoint Instruction will 
provide a total of 32 bits of Inforroation* The convention 
uses 12 bits of this for keypoint identification and the 
remaining 20 bits as user supplied data* Try to use this 
20 bits to provide meaningful Inforniation (taskJd* segment 
number* flieid* qyeye length* page number* time* etc*)* 
On DATA class keypolnts the data i^e longs to the pr alloys 
keypoint and the full 32 bits is available for additional 
user data. 
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4 • 7 • 1 • 1 0££ClilOja.SlSitl 

Tf^e ke^polfit ot tsses for MOS/VE are as followss 
OSC$OATA«0 

osc$yNusyAi=i 

0SC$£NTRY=2 

0SC$iXIT«3 

0SC$DEBUG=4 

Keypoint class 5 is reserved for HOS/VE. 

Ttie operating systeiB keypoint multiplier Is OSKSH« 

4«7,1.2 IgaiUSt^^Mt 

The keypoint classes for the prodyct set are as follouss 

PS C$C4TA= 6 

PSCSyNySUAL«7 

PSC$ENTRY=8 

PSC$£XIT=9 

PSC$D£ByG=lC 

The prodyct set keypoint myltlpller Is PSK$W« 

4, 7 a ,3 Qiiiat.cijsisji 

The keypoint classes 11-14 are reserved for users* 
Keypoint class 15 Is reserved for PHf liardiiare control* 

The keypoint myltlpMer for yser defined keypolnts Is OSK$M« 

4,7.2 KEYPOINT IDENTIFIERS 

A MBxlmum of 63535 keypoint Identifiers are avallalsle for 
(each) NOS/VE and the product set* The coait} I nation of 
keypoint class and Identifier Is ynMue Mithin the systeii* 

4* 7*2*1 QEfiCailDa-S^Sttl 



The set of 4096 available Identifiers is assigned to operating I 

systeip areas in blocks of 30* Some areas Clf neededl mI 1 1 receive I 

tMO consecutive blocks of 50* The NOS/\/E performance project has I 

responsibility for asslsnlng the ranyes to areas of the operating t 

systen^* I 
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4,?«2.a. Gpar 


atlng S^steia 












ng system 


ares 


Area Identifier 


Range 




Cnot 


us €4 } 





» 


49 




AH 


Access Hetlioci 


50 


— 


149 




BA 


Basic Access Hetliod 


150 


- 


249 




CI 


Cctnniand Language 


250 


- 


299 




CH 


Conf J gyration Management 


300 


- 


349 




Cfut«re €Mpanslof^> 










OH 


Device Hanagedient 


400 


— 


549 




Cf 


ytyre expansion) 










IC 


Interstate Communications 


600 


- 


649 




IF 


Interactive Facility 


650 


- 


699 




II 


Interactive Interface 


700 


- 


749 




C future €Kpanslonl 










JM 


Job Management 


800 


- 


849 




L€ 


to gs 


850 


- 


899 




Cf 


uture expansion) 










LO 


loader 


9f0 


- 


999 




tfutyre tjspsnsJor?) 










HI 


Heiaorj^ Link 


1050 


~ 


1099 




m 


Memory Managenent Monitor Mode 


1100 


- 


1149 




m 


Memory Management Job Mode 


1150 


- 


1199 




m 


Maintenance Services 


1200 


- 


1249 




m 


Monitor 


1250 


- 


1299 




ac 


Object Code Utility 


1300 


- 


1349 




OF 


Operator FacI 1 Ity 


1350 


- 


1399 




OS 


Operating Systeis 


1400 


— 


1449 




Cf 


ytyre expansion) 










PF 


Permanent Fi les 


1500 


- 


1599 




Cf 


uture ixpans Ion) 










l>H 


Program Management 


1600 


- 


1699 




RH 


Remote Host 


1750 


- 


1799 




SR 


Conversion Services 


1800 


- 


1849 




ST 


Software Tools/Set Management 


1850 


- 


1899 




TH 


Task f^anagement flonltor Mode 


1900 


- 


1949 




TM 


Task Management Job Mode 


1950 


— 


1999 




JS 


Job S*«apper Monitor Mode 


2000 


— 


2049 




JS 


Job Snapptr Job Mode 


2050 


— 


2099 




AV 


Accounting Validation 


2100 


- 


2149 




SF 


Statistic Facility 


2150 


- 


2199 




10 


Input / Output 


2200 


~ 


2249 




Cfuture expansion) 










DM 


Device Management/ Tape 


2300 


- 


2349 




ST 


System 


2350 


- 


2399 




NA 


Network Access Method 


2400 


— 


2499 




ML 


Network Access Method 


2500 


- 


2549 




NL 


Network Access Method 


2550 


- 


2599 
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Cfutyre expansloi^) 
FH ¥\ le M^nageffient 
FS FI le System 
RM Resource f^enasement 
NA HetKorJ* Access / Monitor Mods 

Cfiityre expansion) 
HI Monitor 



2700 


~ 2799 


2800 


- 2899 


2900 


~ 2999 


3000 


- 3049 



4000 - 4049 
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Ttie k«ypolnt reduction iitHlty a«d the «ontlnyoys nonltorliis 
facility depend upon tfee foitoMing keypoint yalyas* Ttiesa routines 
should be modified to use the keypoint nafises and not the keypoint 
valyes listed btloii. Tills modification sliould be ©onipleted by 

NQS/VE release l.Zml (second quarter 1986) • 



4001 Entar / Exit Honltoc Hode 

4002 Enter # €x|t NOS 170 

4003 Honltor Hode Trap Handler 

4004 Job J^ode Trap Handler 
2200 Series Physical I/O 
1106 Page fault Processor 
1149 Convert PVA to SVA 

19 06 Queue Task 
191S S**ltch Task 



^tk$Jofo«entry.exlt 
«itk$170.entry.eKlt 
wtkSiBon I tor.fflode.tr ap 
8? t k $ J o b^m ode.tr mp 

mrokSpage.f aui t 
is»k$systeiR.¥ I rtyal. address 
t«k$^yeye.task 
tfflkSsnltch.task 



4. 7,2.2 Etfidy^t-lfil 



Tlie set of 65S35 available Identifiers Is assigned to products 
In blocks of §€• Tbose product set meiiibers Mblcfi require isore 
t]ian SO Kill be assigned one or »ore additional blocks* 
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4.0 SYSTiHyiDi CONViNTIONS 
4.7*2.2 Product Set 



Assigned ranges are: 



Prodyct Identifier 


Range 


Clnvalid) 









Ak 


Advanced Access Method 


1 


- 


49 


AP 


API 


50 


.. 


99 


8C 


BASIC 


iOO 


- 


149 


CB 


COBOL 


150 


~ 


199 


OB 


Interact If e Oebyy 


200 


- 


249 


FC 


FORTRAN Conipller 


250 


- 


299 


fL 


Fortran Ryn-Tl«Re 


300 


- 


349 


FH 


File ^snagensent Utility 


350 


- 


399 


FT 


FORTRAN Slofeal 


400 


— 


449 


m 


Inforinat ion Hana^ewent 


4S0 


,« 


499 


PA 


Pascal 


500 


— 


549 


PI 


PL/I 


550 


- 


559 


QU 


Oyery Update 


600 


- 


649 


sn 


Sort/ilerge 


650 


- 


699 


sv 


Shared Variables Processor 


700 


- 


749 


cc 


Common Coropiier Modules 


750 


- 


799 


CG 


Coniflion Code Generator 


800 


- 


849 


{fy 


itura prodyct) 


850 


- 


899 


HL 


Math Library 


900 


- 


949 


CY 


CY3IL 


950 


- 


999 


SC 


Soyrce Code Utl 1 Ity 


1000 


- 


1049 


At 


Assembler 


1050 


- 


1099 


FA 


FHe fflgratlon Aids 


1100 


- 


1149 


II 


LISP 


1150 


- 


1199 


AD 


Ada 


1200 


- 


1249 


FV 


CDC Fortran 


1250 


- 


1299 


VX 


VX/VE 


1300 


- 


1349 


VC 


C cofipl ler 


1350 


^ 


1399 


PT 


Performance Tools 


1400 


- 


1449 


KR 


Keypoint Reporting Utility 


1450 


- 


1499 


NF 


Network File Transfer 


1500 


- 


1549 



(Reserved for fytyre products) 
AA Advanced Access (2nd block I 
(Reserved for futyre i>rodycts} 
4.7.3 KEYPQIHT USE 



1550 - 1999 



2000 - 2049 



2050 - 65535 



FroiD a software point of ¥leM^ keypolnts are special 
comtnands that are Inserted In a module according to the 
guidelines specified In section 4«7«1« For a oiodyle 
written In CY8IL, the #KEYPOIHt Intrinsic can be used to 
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4,?,3 KEYPOIHT USE 

ganerate the keypoint instruction (refer to CYBIi ianiyage 
Specification* ARH2298, and HIGDS> mHllQOf for d#t«lls3* 

Ike inain entry keypoint Identifying a product set sefflfeer 
should Inclyde cata Mhich Indicates the actual version of 
the product* This Is usefyj for tracking slisyl ttneoys 
execution of the same or different versions of a prodyct* 
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5.0 COHflLER mn AtSSEHBtY CODE CONVENTIONS 



5*0 QOIi£IL£S^iMa«i^S£Bail«am£-£iMMiliIifl!iS 

Tl^ls stanilard Is to be fci lowed by tht object code 
generated b^ tl^e compilers and by any assembler code 
written as part of standard software* 

In addition to tbese standards^ assembler code 
liiandwrltten or compiler generated) will conform to the 
coding standards described In CysER 180 MAINTENANCE 
SOFTWARI CODING CONVENTIONS C DAP ARH2160) * 

5 . 1 illi.Q£.LfliO£E.£f ililEI^ 

1, Tiie loader specification is limited to that written In 
Its fomal docuroentstlon* Programmers shall not 
depend on additional characteristics determined by 
empirical observation^ as sych belia^lor nay be sybject 
to change* Examples which have caused troyble on 
CYI70 are tlie presetting of undefined yarla|}|es» the 
order of loading from a I Iferaryj and the address at 
which the first code 3s loaded* 

2. Runtime routines shall not llpit the prosrai» 
structures of their users* On CY17C ail CRH 1 
routines must be In the root segment of a segmented 
load^ and Cf^H must hme at least one routine In the 
main overlay of an overlaid program* Such 
restrictions must be avoided on CYIBO* 

3* The following table shows In which sections particular 
types of data should be allocated^ and the attrll^utes 
the section should have* 

Attributes R * read* y = write* B - Binding and 
£ s execute* 

Section 
Data Type Type Att Comment and Examples 

"Static** Working R* y All variables not 

allocated on the stack* In 
common or explicitly 
allocated to a section* 
Includes FORTRAN local 
variables* CYBIt ISTATIC3 
and CXDC13 variables* 

Constants! I) Working R Ail literal constants 
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5.1 USE Of LCADER FiATURES 



lifiich for reason of 
Indirect addressing or 
lenstts cannot be exisressed 
directljr in ttie code. 

Constants (2) Code £ Optional iy# constants as 

In 11) nhich are less than 
3 bytss long and 
con^enlentif accessed 
tlirougli the LBYTP 
Instryctlon. Note that 
tlie "constant* may not be 
a PVA. 

"XREF" Binding 8 Data declared in another 

unit of coiBpl latlon are 
ysually referenced through 
pointers placed In the 
binding section by the 
loader Crather than In 
yser sections indirectly 
referenced throygli the 
binding section^ Nhere 
tliey Hoyid be Inaccessible 
to the binder). 

Heaps compon 

extens- 

I tie R#W For the system heap see 

section 5.4*3. Other 
heaps ^re declared in 
CY8IL. 

4. The foi ioxing action should be taken If a compiler 
detects a fatal error in the source code It Is 
compiling^ unless the conipller Mas called Mith 
"OEBUG^OC" (see section 2.2)3 

An lOR record shall be Issued containing the string 
"errors In compilation" 

in the coroipent field. The non-executable attribute 
shal I be set* 

If CEBUG-OC N8S selected? the coaipJier shall continue 
normal processing as far as possible. 

5. All compilers should emit loader natpes (cominon block 
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5.0 COnPILfR md ASSEHBLY C00£ COHVENTIGHS 

5.1 USE OF LOADER FEATURES 



names^ XREf naipes# ipodyie naaies^ €itc*l ysing upp^f 
case alphefcetlc letters wlien letters o€C«r In ttie 
names. An exception to this ryte Js made f^r any 
langyage Mliich re^iylr^s the distinction between ypper 

and loMtf case nait^es* 

Pyrpose 

The purpose of the inter i tnyuase callinis sequence Is to 
facilitate Inter-language procedure calls* This Is 
parti cyl ar li^ desirable on CY8ER 180 because of the systeis 
level support for sharing of code between executing 
tasks* For exaaiple> It i*ould be desirable to have only 
one set of mathematical routines to be used by all 
languages* 

Restrictions 

All CYBER 180 Compilers aust be capable of generating the 
CY86R 180 Inter I anguage Calling Se^quenca for an eMternally 
refer enceable code !Podyle« It Is a goal In the definition 
of this calling sequence that It be useable by the 
fiiajorlty of the ccmpllers as a subset of their standard 
calling sequence* It obviously cannot meet all of the 
needs of languages bs diverge as BASIC and Pt/I. It Mould 
be acceptable (but certainly not preferable) If a 
particular language Mere to require special declarations 
or attributes on e procedure call to cause the generation 
of this calling sequence* 

ft Is expected ttiat users In the various progratsning 
languages may hate to take additional steps Mith respect 
to data declarations to guarantee that the alignment and 
packing correspond to that specified by this Interchange 
standard* The user Is also responsible for the values 
passed via this celling sequence* For exaisple^ a Boolean 
variable vilght contain values 0-7 (since It occupies a 
byte) but the copii!on calling sequence only assures 
I nter I anguage capability for the values and 1* 
In generals a compiler nsay employ any calling sequence It 
chooses between Itself and its library or non-external 
procedures* Exceptions to this Kill I be for routines Mhich 
can be of general use to ipany languages (e«g*» math 
library routines). Such routines iRay have a fast calling 
sequence but taust also provide an entry point conforaing 
to the Interl anguage calling sequence* 
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5.0 COMPILER AND ASSEH8LY CODE CONVENTIGHS 
5.2.1 CALLII^G SEQUENCE FORMATS 



5.2.1 CALIIMG SEQUENCE FCRHAlS 



Tt^e Ifiter I sngyiie caillng sequence Is daflDed to inclydt not only 
tfie layoyt of tlie parameter list* tut also ttse layoyt of any 
descriptors associated mith paraiaeters in ttie list. Tuo formats for 
the Inter Jangyase calling se^iyence ire available. The terw 
"inter! angyage csillns setiy^nce^* Is ysad to refBf to ttiese tito 
formats ocl i ect ively. Two different formats are renyired In order 
to proflde flexlbilltf of usage frow language to language Mlille not 
ynraasonaislf degrading performance and ysablllty. These ti«o formats 
will be referred to as the "S^rstem*' and w^eneral" formats. 
EKtensions to either of these formats mmy be made yla a DAP against 
the SIS. 

The calling sa^iuence provided by a coiBplier for use betMeen Internal 
prooedyres and fynctlons knonn to be nrltten in the snme language 
need not conforjn to either format of the Inter language calling 
setruence. Additionally there Is no re^iulreiaent to y$e the 

Inter I angyage calling se^iuence beti«een compiler generated procedures 
and functions and any assensbler procedures and fynctlons provided In 
a runtiflie library specific to that language. In generals assembler 
procedures and fynctlons are responsible for accepting a parameter 
list format of the kind generated by their potential oallers* 
However calls to the scalar CHHl cal l-fey-ref erence procedures and 
fynotions must conform to the System formats mhlle calls to the 
vector/array CMHL call-by-reference procedyres and fynctlons aiust 
conforro to the General format. 

5.2.1.1 l<iEdS.fif.£j£lifii££& I 

For purposes of axposltion* six kinds of parameters i«lll be • 

distinguished* simple value parameters* extended value parameters* I 

siipple reference paran^eters* extended reference parameters* simple I 

bit reference parameters* and extended bit reference parameters. I 

Value parameters are those parameters for Mhlch a value Is Intended 
to be passed. The calling program can assyme that the actual 
argument It passes mM I not be changed by the called program. Note 
that this does not Implj a specific Implementation technMue 
(several are possible). Some value parameters also require that 
certain descriptor Information must be passed along with the value. 

Simple value pareeeters are those value parameters Mhlch re<iulre 
only a value to be passed to the called routine* 

Extended ^slye parameters are those value parameters which are 
composed of a value plus a descriptor. Included in this category 
Bte polnters-to-PrOcedure when they are accompanied by a static 
I Ink. 
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5*0 COHPILER AND ASSEnStY CODE CONVEHTIOHS 
5.2.1#1 KIncIs of l>arajiieters 



Reference paramaters are thos# paraweters for *ililcii a« object Is 
Ifitended to fce p^ssBdm The calilng prograai myst assume that the 
actual argyfner^t it passes may be changed by ttie called prourtm* 
Note that this does not Imply a specific implementation technl^iie# 
aitfioygh at least an address must norisaliy bm passed* Sofae 
reference psranieters also re^ylre that certain descriptor 
Information layst be pBsse4 along Mith the %Mr&ss* 

SNple reference paraaieters are those reference paraieeters Mhlch 
reqyire oniy an address^ or only an ^44fBS& plys a string 
descriptor* to be passed to the callini routine* 

E}<tended reference parameters are those reference paraaieters which 
are codiposed of an address plus a string descriptor plus a 
non-string descriptor* or of an a44t^ss pius a non-string 
descriptor* 

Slinple bit reference parameters are those reference parameters which 
require only an ^44fess plus a bit string descriptor plus a bit string 
offset to be passed to the cabling routine* 

Extended bit reference paraiieters are those reference parameters *ihlch 
are composed of in address i>lys a bit string descriptor plus a bit 
string offset plus a non-string descriptor* 

This forpat Is the one used fey the systeiR I j^Pleaentatlon language 
CCYBID* and all operating systeii Interfaces* This foriaat Is 
documented In detalil In section 5«2»5«l of the SIS* 

5*2*1*3 a£Q&£2i.£g£lli;.fi|.ibfi.XQiJl£i£aiillli3S.£siIl£fl«2iS3y£Q££ 

This format Is nsore general than the system format* It nl 1 1 be usb4 
by Ada and CDC FORTRAN. This format Is documented In detail In 
section 5?*2.5.2 of the SIS* 

§•2.1*4 ium&Li^Qt^tamAM^llill§L&Qum 

The primary difference between the System and General formats Is In 
the placement and content of descriptors* System format and General 
format actual parameter lists are identical If only simple reference 
parameters ^re passed* All System format descriptors are placed 
directly In the parameter list following the PVA of tfie object being 
described^ while General format non-string descriptors are placed 
outside the parameter list* The General format parameter list 
contains the PVA of the descriptor as well as the PVa of the object 
being described* 
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5.2»1»4 Summary of Format Differences 



The System format does not support extended valye paraiieters 
except for polnters-to-proc^dur e* For slaiple talye parameters* 
tl^e Systero Forpat and the General Fcrwat are Identical except when 
the valye paraneter Is less than one word In size. The General forwat 
requires that the va)ye paraieter he right aligned Mlth sign fill on 
the left for Integers and suhranses of integers %n^ zero fill 
other Ml se^ i^hile the System forisat requires right tlliiniiient hyt does 
not define the fill bits on the left. 

Use of the General forsiat of the Inter language calling sequence 
requires that a **hig** {|»e* longer than a wordl valye parameter 
iihlch Is pzssed %la a pointer mIII have been copied hy the caller* 
The passed pointer is a pointer to the copy# and the called prograis 
is free to write Into the laeraory pointed to. The System foraat does 
not specify iiliether or not a ••big" waiye parameter Mill have been 
copied by tlie catler# so in this case the called progran should not 
write Into the flsemory pointed to* 

Any procedure or function which Is Intended to be callable froa an 
external module potentially nrltten In another language should 
accept for that call one (or a subset of one) of tlie tuo formats of 
the Inter I angyage calling sequence* Each compiler iiust docuiaent 
which of the two sequence formats It accepts* or state that none of 
Its procedures and functions are externally callable from another 
language. 

language Inter language Format Accepted 

ADA General Foriaat 

BASIC -not I nt eri anguage callable* 

C -to be determined- 

CQBOl System format 

CYBIL System format 

FORTRAN General format 

Pascal -not Interl anguage callable- 

A compiler n^ay assume that no call It generates Is an Inter! anguage 
call unless the author of the source program has explicitly 
indicated that a particular call Is I nterianguage* This means that 
each language which supports calls to modules Mr i tttn In another 
language must provide a mechanism m I thin the source language tilth 
Mhlch the author of the source program can explicitly Indicate that 
a particular call Is inter I anguage* This mechanism must be 
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fofiylated sucH tliat tke ayttior Is fyrttier r«<«ii|re<l to stat€ 
explicitly (fey nape) ulilch <:»ther lar^gyage Is being csl led* It Is 
tfien up to the compiler to generate tiia correct Inter! angyase 
caiilng seqyence for tlie call* Ttiys t^e compiler ffiyst kticn Mhich 
langyages accept wlilct; calling se<|yences« It regains the 
responsibility of tiie aytfior* not tfie coffipllef# to ensyre tiiat the 
actyal and formal paraineters of the call are compatlbie. T^e 
copplier has the responsibility to generate the correct lajfoyt for 
the parameter list and parameter descriptors^ &s expected by the 
called langyage. 

These provisions do not re^^ylre a conpiler or langyage to provide 
I nter I angyiie eel ls# byt they do define restrictions on hen 
Inter langyage calling Is to be supported* A langyage nay sypport 
inter langyase calls to onl^ a llislted nyisber of ^ther langyases# If 
it so chooses* Note that even If a langyage sypports direct 
Interlangyage calls# It Is not re^ylred to also sypport Indirect 
inter I angyage calls via dereferenced po4nters-to~procedyre« 

5,2.1,6*1 SUPPORT FOR CALLS TO ANOTHER iAHGUASE 

If a langyage sypports calls to tsodyles written in another langyaget 
and that other language accepts calls Mith slnple reference 
parameters^ then the calling langyage mystj at the ^Inliisyffif sypport 
calls i*ith simple reference parameters. A string descriptor teyst be 
sypplled for any object uhlch takes onej ynless the aythor of the 
calling program has expllcitl^f indicated that no string descriptor 
need be passed. An explicit Indication Is possible In langyages# 
sych as CY&IL# ithlch allOM the reference paraineter In an external 
procedyre declaration to be specified as either fixed type 
(descriptor need not be p^sse^) or adaptable type {descriptor must 
be passed) • 

The calling langyage Is strongly encoyraged to also provide sypport 
for calls ^ith valye paranseters and extended reference paraiseters if 
the called langyage accepts sych calls* This sypport Moyld consist 
of a asechanlsia Mithin the soyrce langyage to explicitly Indicate* 
for each actual par«f!3eter of the Inter I angyage call* whether the 
parameter Is to be passed by valye* by simple reference* or by 
extended reference* The compiler then has the responsibility to 
oenerate the appropriate calling se^yence* 



S.2.2 CALL 



The procedyre call Instryctlon CALLSEG* Reference #115 as 
defined in the CYBER 180 MIGOS will bs ysed to perforw the 
procedyre call • 
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5«2,3 REGISTER SAVING CONVENTIONS 

For generalized external calls and calls to formal 
procedyres^ tlie compiler may not assy^e that tti€ eel! ad 
procedyre nIII save and restore registers* Any registers 
to be saved must be saved on the stack using tfia save 
aiechanlsw of the CALL instryction. 

Internal calls need not use the CAILSEG^* Reference #115 
Instryction. That way yse CALLREL Reference #116 or any 
other coda seciyence uhlch meets ttieir needs, far Inttrnal 
calls tha compliers have the option whether to save 
registers or not. Internal calls Inclyde calls to* 

a) the compiler's oi«n library routines* 

b) nested procedures wittiln the s^me o^mpH&ti^^ ynit# 

The folloiiing Inforri^atlon may be re^iulred In inaklng a call* 
Some of the Inforriiaticn Is not alifays required - See footnotes* 

Dynamic to Caller and Callee 

basic stack control r^^glsters <A0# Ai, A2)*** 

• parameter list pointer {A43*** 
static chaln/dlspl ayi" 
binding section pointer (A3)*** 

• product defined Information 
Dynainlc to Calleey Static to Caller 

line number of call Csee traceback section)*** 
. number of pfraroeterslXO* bits 32-47)*** 
descriptor area Indicator 

• descriptor area pointer Cif any) 
Static to Caller and cafi^e 

• name of callee (see traceback section) 
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size of dlspi ajf/nesting depth*^** 

• frawe size/langyage** 

* type of frame J e«g, proc» func* co-proo** 

* Slock struc tyred Itnsuages only* 
** Traceback mode only. 
*** Re^yired on calls wade ultta the Interl angiiage caiiing sequence* 



§•2.4 FUNCTIONS 



A fynctlon is t procedure that returns a value. The 
function value is In tfse registers or In meroory depending 
on the type Qf value belnn returned. Since function 
references are usually part of another expression that Is 
baing evaluatedf it Is general ly desirable to have the 
value returned In a register. 

If the function value is a pointer^ then the value Is 
returned bs a P^A in Af. A procedure catling a 
pointer-valued function must not save register AF on the 
call. A pointer-valued function »ay have the ring nunfeer 
field of AF altered fey the RETURN instruction if It is 
called across a ring boundary. 

If the function value is a scalar of knoMn length less 
than or eaual to 64 felts In lengthj It is returned right 
aligned In XF. A procedure calling sych a function ^ust 
not save register XF on the call. 

If the fynctlon value Is double precision or complex ttien 
the value Is returned In registers XE and XF. XF holds 
the least significant 64 bits of the value. A procedure 
calling such a function rnust not save X£ or XF on the call* 

If the function value is non-scalar then It Is stored at 
the address defined fey the first eiement of the parameter 
list. The second element of the parameter list specifies 
the first actual parameter. 

A scalar function result is defined as follows: 

• CYSIi- - char act er> boolean* Integer^ ordinals* 

subranges* cell* pointer. 

« FORTRAH - ioglcal* Integer* real* double precision* 

complex* FORTRAN boolean** 
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• COBOL - copp* comp-l* coiPp-2# boolean. 

Pt/I - ifit€serCfIXED R€AL), reaMftOAT ^£41)* 

co«pl€x(C0MPt£X3 

BASIC - real. 

• Pascal - Integer? lenyijiersted typ€# S4ib-ran«e)» 

real 

Scalar function values sr^ retyrned r I gfet aligned In the 
resylt register. 1=111 Iff anyl Is zero felts. Note tliat 8 
bfte numeric Items require no fill. 

* FORTRAN boolean corresponds to a fyll CYBER 180 word lilthoyt 
type* It Is not the same as tlie boolean type mentioned 
elsewhere In tlils section* 

5.2.5 PARAMETER LIST 

The paraineter list Is allocated on a i«ord boundary In flse«ory* £acti 
entry In the parameter list must also begin on a nord boundary* On 
entry to the calleof register A4 *illl point to the paraweter list. 
Bits 32-47 of register XO kIII contain the nymber of paraipettrs 
CInclyding the pseudo Parameter for non-scalar valued fynctlonsl. 
If the procedyre being called Is a function Mliose value is to be 
returned In m^moryf the first element of the paraiaeter list defines 
the location at «<iiich the value Is to be stored. If no parameters 
(nor pseudo parameters} are to be passed* then the contents of A4 
are undefined and xO must specify zero parameters. Under certein 
clTGumstances uetalled below;> a flag nord must Immediately precede 
the first Kord of tlie parameter list. 

5.2.5.1 S^£t£l.£fitiii.£lCllIi££.iifii 

CThls Is currently documented in tlie CY8IL Handbooks CCSi ARH3078> 
sections "CYBIL Ci/II TYPE AND VARIABLE MAPPING" Cold section 7.1) 
and "RUN TIHE EHVIRCNMENT" subsection "PARAMETER 4>AS$A6£»» (old 8.3). 
The following addition must be made to that documentation In order 
to conform to the SIS* 3 

For any potentially Interl a^guage call In which a System format 
actual parameter list is passed that contains only simple reference 
parameters: The parameter list must be Immediately preceded by a 
flag 140 rd whose value Is the 64*blt Integer zero. The string 
descriptor iriust be Included for any object which takes onej unless 
the author of the source program has explicitly Indicated that It 
need not be passed. These restrictions are made to Insure 
compatibility between the release 1.1.2 product set calling 
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copy eiitlof>s and ttiose for all future releases* A flag nord need ^©t 
precede any otfser System fomat actyal parameter lists* 

The General forfliat parameter list aiyst aluays be preceded Isy a flag 
nord* Tfee parameter list Itself Is composed of ti«o parts* Tl»e 
first part has eicsctly one Mord for eacli parameter Clnclyding the 
pseudo parameter for non-scalar yalyed fynctlonsi* If tl^e flag word 
preceding the parameter list Is zero than only this first part is 
presents otherwise the second Cexterslon) part myst also l>e present* 
This ptraipeter list extension follows Immediately after the first 
part of the parameter ljst# and has eitactly the same length In 
words* There is a one-to-one correspondence between nord J of the 
first part and word J of the extension* 

The paraaeter list extension is required If and only if one 
or more of the actyal parai^eters Is an extended yalye parameter 
or an extended reference paraaieterj or a Cslwple or extended) 
bit reference par«fl?eter* 

§.2*5.2*1 FLAG yORO PRECiOIHG FARAMiTER LIST 

The flag mcrd ifflinedlateiy preceding a General forinat actual 
paraiReter list wust be present for any potentially Inter! angyage 
call. This flag word has the follonlng Internal stryctyres 

record 

fl2 C.Offffffffffff C16), 

f23 0..0ff(16l, 

f3i 0*.Cff<i6)# 
r ecend 

Field fl must 8l)«ays be set to integer zero* It Is reserved for 
futyre yses. Field f2 has a langya^e dependent valye^ but may be 
nonzero only If field f3 Is nonzero* Fieid f3 »yst be set to 
Integer zero If the parameter list extension Is absents and isust be 
set to Integer one otherwise. Any langyage accepting calls 
according to the General format must accept Inter I angyage calls for 
Mhlch field f2 Is zero* An Inter I anguage caller »fill never be 
required to set field f2 to a non-zero value. If field f2 Is set to 
a non-zero valye for an Inter language callj It Is the responsibility 
of the caller to set the flald according to the expectations of the 
c a 1 1 e e « 
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f. 2 .5.2.2 GENERAL FCRHAT SIMPLE VALUE PARAHiTERS 

If a siropis vai4i€ para««ter Is ir«ater than Qne word In I angtli and is 
not a pointer-to-pr ocedur€> tlian It Is passed using an Identical for«at 
to that for a refer enca parameter* 

If a slfiiple yafye parameter Is a polntef-to-procedyre then tlie first 
part of ttiat parsiseter list entry «yst contain ttie left justified PVA 
of ttie Code Base Pointer of ttie procedure In tlie binding section. The 
second part of the entry {wlien an extension Is required) «yst 
contain the NIL pointer. Th« 16 bits to tlie right of each of these PVAs 
Is unused and undefined. This can be dlagrataised as: 

I fVA (Code Base) t uadef I t NIL I undef I 

4. , ^ . — ««-. 4. ^ ^ ^ .4..-™.-.—™-*™™™-.— ..--.4 

If a sliiple value paraoieter Is less than or e^ual to a Kord In lengtht 
then a copf of the value Paranieter Is placed directli' In the first 
part of tjie paraweter list right aligned In a Kord* nith sign fill on 
the left for integers and subranges of Integers and zero fill other>ilse. 
The associated nord In the second part (nil en an extension Is 
required) Is unused and undefined. Note that If a PVA hating no 
associated descriptor is passed by valuet then bf this rule the PVA 
Is placed directly In the parameter I Istt right aligned In a i«ord» 
kiitn the Mord zero-filled on the left. This can be diagranssed as: 



value Cright Justified) I I undefined I 



J 

5.2.5.2.3 GENERAL FORHAT EXTENDED VALUE PARAHiTERS I 

i 
• 

If an extended value parameter Is greater than one ^ord In length 

(excluding the descriptor) and Is net a polnter-to-procadure# then 

It is passed using an Identical format to that for a reference 

parameter* Use of extended value paraoieters re<3ul res that field 

nuniber three of the flag xord preceding the parameter list aust 

have been set to one. 

If an extended value parameter Is a pointer-to-procedure* then the 
first part of that parameter list entry must contain the left 
justified PVA of the Code Base Pointer of the procedure In the 
binding section. The second part of the entry must contain the 
left justified PVA of the static link. The 16 bits to the right 
of each of these PVAs Is unused and undefined. This can be 
diagrammed as: 



.— . + + • — -. , 4. 

FVA (Code Base) I undef I « Static LInK * undef I 
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-+ 



If an extended value paraiaeter is l€ss than or e«iwal to e Kord In 
lengths tfitn « copy of tl^e value parameter Is placed directly In 
tlie first part of tlie parameter list rlgl^t aligned in a i«ord# mlth 
sign fill on ttie left for Integers and subranges of Integers* and 
zero fill otherwise* Tfie associated word In t^e para««ter list 
extension for this entry Nllf contain the PVA of a location (which 
iDUSt be on a Mord boundary) In meroory where the descriptor is 
located. The PVA In the parameter list extension Is left aligned 
In a Mord Kith the rightmost 16 hits being ynused and undefined. 
This can be d iagrafflped as: 

+ ♦ + ' — ' + 

i Value tright justified) I I PVA {descriptor)! undef I 

3. 2.5. 2,4 GEI^IERAl FORHAT SIMPLE REFERENCE FARAHETERS 

Simple reference parameters are passed either as a PVA or as a PVA 

plus string descriptor. Parameters consisting solely of t PVA are 

Placed directly in the first part of the par araeter list entry left 

aligned In a Kordi tilth the rightmost 16 bits of the tiord unused and 

undefined. The talue of the nord In the associated second part Clf 

an extension is required) wust be tlie 64-blt Integer zero. This can 
be d i agran^fl^ed as: 



+ ^.^ ^^, ^ + 

I PVA (Object) I undefl 

^^. . — , — , — . + + 



Simple reference parameters consisting solely of a PVA plus a string 
descriptor are placed directly In the first part of the parameter 
list entry i«lth the PVA left aligned In a Mord^ folloi^ed I immediately 
by the tHo byte long string descriptor* The value of the word In 
the associated second part Clf an extension Is required) must be the 
64-bit integer zero* This can be diagrammed as: 



™ ^ -.4. +. — ^ — ——«.— ™™+ 

PVA (Object) iiengthi I € I 



,+ —4. 



I 

5.2*5*2.5 GENERAL FORMAT iXTeNDEO REFERENCE PARAMETERS J 

i 

« 

Extended reference parameters require that the non-string descriptor 
be passed Indirectly using the parameter list extension* regardless 
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of the size of tlsat descriptor* Flel<j f3 of the flag word preceding 
tl^e parameter list wust have been set to one. T*i« first part of tlie 
parameter list entry wHI contain the PVA of the object referenced* 
left aligned* If the reference inclydes a string descriptor then 
that descriptor is placed In the 16 bits laiffledlately following the 
PVA» othemlse those 16 bits are ynysed ^n4 yndeflned* The 
parameter list extension for this entry Kill contain the PVA of a 
location Ciihlch must be on a word boundary) In ffle»ory nhere the 
descriptor Is located* The PVA In the para«ieter list extension Is 
left aligned in a Mord «iith the rightmost 16 bits belns unused 9n4 
undefined* This can fee dlajrafflcsed as one of 3 



+ : «- — ^«. -4-: ... ^ 

I PVA rob Ject) I yndefl 

+ , +. ^ — 4 

J PVA Cobject) llengthi 

+-««.-- .- ««-.™.— .™-4— . — -.-.4 



4«- ™„™.«.«-4«™™4. 

I PVA Cdescrlptorl I yndefj 

^ 4 .^ — ^ «^«^,«^^4— .—- -4 

I PVA C descriptor) • yndefl 

^ 4™ ^ -^- — , ^-4— — --4 



5*2*5.2*6 GENERAL FCRJ1AT SIHPtf SIT REFERENCE PARAMETERS 

Sippie bit reference parameters are pnss^4 as a PVA piys a bit string 
descriptor plus a bit string offset* The PVA and bit string descriptor 
are placed directly in the first part of the parameter list entry 
Mith the PVA left aliened in a Mord» followed Immediately by the 
two-byte long bit string descriptor* The value of the word In the 
associated second part Can extension Is always required! consists of 
a left aligned 4a-blt Integer zero* followed by the t*io-byte long 
hit string offset* This can be dlagraisffled as: 



.+ ^ ^ «-.+ + 

I PVA (Object) llengthi 

+ + + 



SoffsetS 



f.2.5.2.7 GENERAL fORflAT EXTENDED SIT R€FER£NC£ PARAHETERS 

I 
Extended bit reference pararaeters require that the non-string descrlptorl 
be passed indirectly using the parameter list extension* regardless of 
the size of that descriptor* Field f3 of the flag word preceding the 
parameter list iBust have been set to one* The first part of the 
paramater list entry will contain the PVA of the object referenced* 
left aligned* wlt^ a bit string descriptor placed In the 16 bits 
Immediately folloi<lng the PVA* The parameter list extension for this I 

entry lilil contain the PVA of a location (which isyst be on a word \ 

boundary) In nseniory where the descrrlptor is located* The PVA In this • 
parameter list extension Is left aligned In a word* followed by the I 
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tMo-lsyte iofis bit string offset. This cars tn 4i^Qmmme4 ass 



+. — . , «+ + ^ — , ^^.- — + — ^_^-.+ J 

i ?VA (cbjtct) lienatfel I f>VA Idescrlptorl loffsetl I 

+. , — : ^ ^i. ^ .4.— ^«> -, — . — — —«.•+«.—.««.« 4 I 

f 

i 

5.2.5.2.8 OEHiRAi FORHAT STRING DESCRIPTORS I 

• 
A string descriptor Is a 16-ijlt unsigned integer <0. .65 5 35 1 
Indicating the iengtti of a string in fcftes. Mhen present* It is 
placed In ttie prinary portion of tl^e piranseter list Isiiedtately 
foil oiling (and In tlie satire Mord as) the PVA of the ol3ject heing 
described. A string descriptor is required for all reference 
parapsters to ol^Jects of type character* subrange of character* 
string* siiljstrlng* or array oyer a coaiponent typa of character* 
subrange of character* string* or sybstrlng. The strlpg descriptor 
for an array Indicates the length In bytes of a single eleiaent. 

f.2.5.2.9 GENERAL FORHAT BIT STRING OESCRIfTQRS I 

I 
A bl t string descriptor Is a 16'-blt unsigned Integer I0^D«.65535I I 

Indicating the length of a bit string Jn bytes, yiien present* It is I 

placed In the primary portion of the paraiieter list Ipffltdlately I 

folloMlng (and In the same nord as) the PVA of the object being i 

described. A bit string descriptor Is required for ai I reference 
parameters to the objects of type bit* bit string* bit substring* or 
array over a cofflponent type of bit* bit string* bit substring* The 
bit string descriptor for an array indicates the length in bits of 
a single element. 

5.2.5.2.10 GENERAL FORHAT BIT STRING OFFSET 

A bit string offset Is a 16~blt unsigned Integer with a walue In the I 

subrange C..7. Indicating the offset of a bit string* in bits* frow a I 
byte sKi<iT%ss* When present* It Is placed right aligned In the extended 
portion of the peranieter list. A bit string offset Is retiulred for all 
parameters to objects of type bit* bit string* bit substring* or array 
over a component type of bit* bit string* bit substring* The bit 
string offset for anarray indicates the offset of the first eleisent 
of the array fron^ a byte address. 

5.2.5.2.11 GENERAL FORMAT ARRAY DESCRIPTORS 

The layout of an array descriptor roust adhere to the pseudo-CY8IL 
description given below. Note that "extent** refers to the nuaber of 
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elements In a particular dluians ion# *'stri<i«'' refers to tfee distance 
(peasyred in terms of array eienientsi betneen tt«o consecutive 
elesients of tt^e sarse olisefision* ^n4 '•rank*' refers to the nymber of 
dlipsnsions in tt^e arr3y« Array descriptors nyst be allgnecl on a 
word tJoyndsry» 

a^rr ay.descr I ptor - array £1 •• rmkl of record 

ejctentJ integer* 

strides Integer* 

lowtr.feoynds Integer* 
recendj 



f«2.5.2.1ia St£ijl5 
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strlded) = Incr(i) * 



£(j) 



j«G 



where stride(i) Is the stride In the i-th dimension* Incrd) Is the 
increment of the i-th diirenslon* and ECO) Is defined to be one. For 
contiguoys arrays* Eij) Is the extent of the j-th dimension* For 
array sections* ECJ) Is the extent of the J-th dimension of the 
contiguous array of which this Is a section. For example If we have 
the FORTRAN declarations 

DIMENSION C(15*30) 
then for C wt have: lncr(l)*l* lncr(2)-i* «xtent(l) = 15* 
extent(2)=30* £{1)«15* EC2)^30* strideCi)*!* and str ide(2)=15. For 
the s set Ions 

CCl-1032* 12S22S3) 
we haves lncr(l)*2* incr(2)-3* ext€nttl) = 5* extenti2)*4* £U)*15* 
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EIZ)^30, strl<ie41)*2*l*2> an^ str I del2) = 3*l*15«45* 

For arrays whlcli bt^ stored roMnise in memory ll«a« uith the 
rls^tfliost syfescript varying fastest) tlie folloi«ing formuiB Is used: 

r+1 



strldeill = lRcr(«3 * I I £U> 

• « 

where strldeU) Is the stride In the l-tti d^nenslonj Incrll) Is tlie 
IncrenJent of the l~th dimension* r Is the r^nk of the array* and 
£(r+l) Is defined to he one. For contlguoys mrrMysM ECJ) Is the 
extent of the J-th dimension* For array sections* £lj) Is the 
extent of the J~th dimension of the contlguoys array of which this 
Is a section* For €Miif*ple If we have the FORTRAN declaration* 

ROi^yiSE RC15*30) 
then for R we haves r=2* IncrCll*!* lncrC2)»l# extentlll*l§* 
eMtentC2) = 3C* £U)=15* £{2)*30* str I deCll=*30* and str}del2)*l» For 
the sections 

RtlMC3 2* 125 225 33 
we haves r*2j lncrCl)*2* lncr(2) = 3f extentil)»5* extent(2l=4* 
E(l)=15* £(2)^=30* strldell)==2*l*30=60* and str Idet2} = 3*l«3. 



5.2*6 DATA REPRESINTATION 

The folJowIng subsections define the representations of 
data which must he used If an I tetn of a particular type Is 
to be PQ&st4 between languages* Languages may haire types 
beyond these byt data of those types cannot be pBsse^ to 
other languages* A language Is net forced to provide for 
all of the follcwing data types* 

§.2*6.1 Ictiaafil 

An Integer pay occupy 1 to 8 bytes of storage* For 
languages with size allocations dependent on the subrange 
of integers specified* the amount of storage allocated 
ifiust be the nilnlmuni nuniber of bits needed to hold the 
specified range rounded up to the next full byte* 
Subranges that Include negative nuipbers ir,ust use the 
lefti«ost bit of the field as the sign bit* Negative 
values Bte represented as negative two^s cosiplenient 
quantities* Subranges of only positive numbers will not 
provide a sign bit* The range of signed integers Is 
•2**63 < I < 2**63-1. The range of unsigned Integers Is 
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< i < 2**63-1. 

Several langutses liave an enynerate<l type called 
ordinals. Tliese Mr% mapped onto the non-negative 
Integers. Allocation rules are tlie sa^e as for unsigned 
Integers* If ordinals are passed to a langyage Mitlioyt 
ordinals they myst fee treated as Integer values and 
vice- versa* 

Tmo sizes of Integers correspond to easily ipanlpulated 
harditare formats and are Identified as separate sybtypes 
of Inteser to provide for languages with only options for 
half or full word signed Integer values. 

5.2.6,1.1 4 BYTE INTEGER 

A half Integer will be represented by a 4 byte C32 bitl 
quantity In tlie CYBER 180 Integer forraat l*e.# a signed 
two's cofiplement 32-blt <?uantlty^ In which the leftmost 
bit Is the sign bit. The range of 4 byte Integers is 
-2**31 < I < 2**31-1. 

5.2.6*1.2 8 BYTE INTEGER 

A full Integer Hi 11 be represented by an 8 byte C64 bit) 
quantity In the CYBER 180 Integer format I.e.* a signed 
two's cofflplenient 64-blt quantity* In nhich the leftmost 
bit Is the sign bit* The range of 8 byte integers Is 
-2**63 < I < 2**63-1. 

§.2.6.2 glJi&i^l&nMth^^hBtSat&L^i^ttiQLSLl 

Fixed length character data mIII be stored as a se^iuence 
of consecutive 8 bit bytes. The character set Nil I be 
ASCII. 



5.2.6.3 Esalj 



Real oata kH) be represented by an 8 byte C64 bit) 
quantity In the CYBER single precision floating point 
format. All real data mIII be normalized. 



5.2.6.4 2&Ut^iS.££££i&ifiQ 



Double precision data mIII be represented by a 16 byte 
C128 bit) quantity in the CYBER 180 double precision 
floating point forinat. It must be nonsallzed. The PVA In 
the paranieter list points to the first byte of the double 
precision datuir. The second (loner Precision half) Is 



CYBER ISO System if^terface Standard 



86/02/04 



5.0 COMI>ILER AND AilSSHBLY CODE CONViNTIQHS 
5*?»6«4 Doyfcle Precision 



located at PVA*8 bwtesm Ikt sign and txponsnt fields of 
ti^e toMer part are considered to b& correct at any given 
time* Inpyt and constant assignment routines are 
responsible for Insuring corrct signs and exponents upon 
Initial constryctlon of tlie number* Double precision 
operations Ml 1 1 maintain tills format* 



5»2.6»5 CfliaiSI 



Complex data miii occypy 16 bytes (128 bits) In neiRory and 
♦»i 1 1 consist of tMo reals> where the first real represents 
tfie "real** part and the second real represents the 
"Imaginary" part of the coiaplex «iyantity« The PVA In the 
parameter list points to the first byte of the complex 
datum (the real part). The Imaginary part Is located at 
PVA+8 bytes* 



5*2,6.6 Ififilsao 



Boolean data occupies a single byte* A value of one 
indicates true and a value of zerc Indicates false* 

5.2.6.7 EfiiQtat 

A pointer Is a PVA. It occupies six bytes. Pointers may 
Identify data of any of the other data types* The ni I 
pointer Is defined as a PVA with a ring field value of *"F»* 
hexadecimal^ segment field value ^fff^ hexadecimal^ and 
address field value ••SOCOOOOO* hexadecimal. 

5.2.7 DATA ALIGNMENT AND PACKING 

The purpose of the common calling sequence Is to provide 
the ability to pass date betneen diverse languages. The 
Inter I anguage call Is assumed to represent a seal I 
percentage of all calls and generally be used by 
knowledgeable users. Therefore* for performance In t*ie 
word oriented languages (FORTRAN* In particular) a 
least-connnon-denorol nator alignment of word Is used. 

Data types which require B bytes to store are required to 
be word aligned to improve perforn^ance. This periolts the 
use of the load/store word Instructions which are faster 
than load/store of 8 bytes. The space penalty for nord 
aligning simple variables Is felt to be small especially 
since it costs a iraxlflium of 7 bytes per procedure If all 
the word aligned items are stored contiguously. 
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5.2.7.1 ^JtililfiS 



Variables way 
«l I gnaient of 



fee of any of the above data types. Tfce 
I particular type isyst i)e ^s foiloMS* 



Data Type 

1-7 8yte Integer 

8 Byte Integer 

Cli ar act er(S tr Ing) 

Real 

Ooyfele Precision 

Complex 

Boolean 

Pointer 



AJIgnaient 

Byte 
yord 
Byte 
Mord 
Word 
Word 
Byte 
Byte 



5.2.7.2 SitiiC^yiSS 



Stryctyres eyst begin word aligned. 

Alignment of data to be passed between langyages In 
stryctyres (i^yst be as foil cms ^ 



Data Type 


Al 1 gnment 


1-7 Byte Integer 


Byte 


8 Byte Integer 


Word 


CJ^gf acter ( String) 


Byte 


Real 


Word 


OoybJe Precision 


Word 


Coispiex 


Word 


Boolean 


Byte 


Pointer 


Byte 



If a byte aligned Item Is followed by a nord aligned item^ 
yp to seven bytes may be skipped (and left unysedl to 
regain nord alignment. If a byte I tein follows a byte 
Item^ tliey (Day be In consecytlve bytes* 

5.2 •7.3 kLL^XSi 

5,2. 7. 3.1 ARRAYS GF VARIABLES 

The arrays represent e collection of data Items of one 
ynlforn type. Arrays myst be Mord aligned If the data 
type they contain Is word aligned. Unless reqyired by an 
external standard all languages shoyld store arrays Mltb 
the rlgbtn?ost subscript varying fastest. FORTRAN^ for 
ex ampler Is constrained by ANSI standards to store arrays 
Mith ttie leftmost sybscrlpt varying fastest. If a user 
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passes z iiylti<!li!ienslof^al array betusmn lai^gutg^s nith 
different storage orders* it Is the yser's r espoftsll^ I Nty 
to flared I e tfils* Arrays must fee byte all sued If all of the 
constituent eleirents are byte aligned* The paraoieter list 
PVA Identifies the first element of the array* Subse^iyent 
elements i^ust be contlgyoys and In ascending storage 
address se^^yence* 



5.2.7.3.2 ARRAYS Of STRUCTURES 

If any element of the stryctyre Is re^ylred to be word 
aligned;* each array element «yst start on a Mord boyndary. 

5.2.7.3.3 CQHMQN BLOCKS 

Items iilthin coffiinon blocks myst be aligned consistently to 
achieve Interlangyage coininyn I cation* Common biaclcs ulli 
begin i#ord allsi^ed. Ailgniaent of data Mlthln tlie cosifton 
block liil tl be the same as for structyres. 

S.2.8 LANGUAGE INTiRCNANGi TABLE 

The folloiting table shoifs the possible paraneter types 
that ^iy be used between langyages. If a letter ^ppMMfs 
at an intersection In the table* that type may be ptssed* 



Types are encoded as foiloMS- 

J * l-3> 5-7 Byte Integer = 

H « 4 Byte Integer I 

C * Character (string) R 

D = Ocyble l>reclsion Z 

B ' Boolean f> 

A a Array S 
All - all types of the langyage 



ordinal 

3 Byte Integer 

Real 

Coisplex 

Pointer 

Stryctyre 



cfil I ee 

CYBIL 



cal ler ♦• 

CYBIL 

PASCAL 

FQRTRAH 



PASCAL 



FORTRAN 



COBOL 



PL/ 1 



Al I HIJCBPSAGR ICARD 

HIJCBPSAOR ALL ICA 

ICARO ICA All 



BASIC 



HICBSARO 


HICSPSAR 


CR 


HICBSA 


HIC3PSA 


C 


ICRDA 


ICROZA 


CRA 
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C08CL 


\ HIC8SARD 


HICBSA 


ICROA 


Al 1 


NIC BROS A 


CRA 


PI /I 


HICSfSAR 


HICBPSA 


ICRDZA 


NIC8R0SA 


All 


CRA 


BASIC 


• CR 


C 


CRA 


CRA 


CRA 


Ail 



Notess 

1} PL/I na^ not fiave a <!oybie precision tiata t^pm due to 
possible Nigh overt^ead In sypportln§ the fRaKlrouffl 
precision ryles* Tfiln mI II be deterffiinet^ lat#r« 

2) If arrays are permitted between tHO langyages# the 
type of tlie array is restricted to the types of 
variables ttiat are permitted between the two langyages* 

3) Arrays «f characters in BASIC cannot be passed to 
other langysgesf and vice versa* 



5* Z.B.I gzt&Qil&sl^lut&g^hMms, 



The language interchange table defines the parameter types 
that can be used betii«een pairs of langyages. In many 
cases restrictions exist because a partlcylar language 
iacks a data type, for e^cample^ BASIC lacks Inteier type 
since It stores them as reals. In many Instances the type 
inismatches could be mapped by Interface code lieti«een the 
procedure calls. The folloi«lng fpechanlsn Is proposed to 
support such mapping mhen and If It becomes a requirement. 



In order to 


®ap parawetersf an Intercept routine laust gain 


control froii the 


cal ler# m&p things 


and pass control to 


the callee. 


The 


reverse may be necessary upon return. 


The user sh 


ould not have to be ai^are of the activities of 


the Interface roy 


tine 


or Invoke It 


directly. To achieve 


this^ the loader 


trust 


have a mec^an 


Ism for detecting the 


need for an 


inter 


face 


routine and 1 


nsertJng same In the 


cal 1 /return 


Path. 


The Insertion me 


Chan Ism can be similar 


to the one 


used f 


or Analyze Program 


Dynamics CAPO). 


Detection o 


f the 


need 


for Inserting 


the interface routine 


can be done 


with 


load 


time argument 


checking mechanisms* 



For each pair of languages (X and Y) mhere Interface 
mapping Is desired* loader tables defining relevant 
Information about actual and formal parameters must be 
defined. A routine (activated during loading b^ the 
loader If a call from X to Y Is found) will compare the 
actual and format parameti^r lists to determine If mapping 
Is required* If not* the loader simply links as ysual. 
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Otherwise^ a X to Y mapping foytlne from a library is 
Inserted Into tiie linkage lay tlie loader* 

The X to Y flapping routine receives the actyal and for»al 
parameter list Information frota ttie loader* 

The caller Infomatlcn Is obtained fey giving the P M44fe%s 
of caller to a loader service roytlne utilch returns a l*VA 
If the actyal parameter list InforiRstion for tli# cyrrtnt 
call. Tlie callee Information Is obtained by giving tlie 
code base pointer of callee to a loader service ri^ytine* 

The capping routine yses this Inforisatlon to transforas the 
parameter list and/or data representations before calling 
the callee* When the callee retyrns# tt^e tapper Mill 
receive control tc do any mapping on retyrn parameters* 

1.2.9 REGISTER CALL FUNCTIONS 

In many langyages tiere exist coismonlcy ysed sets of 
functions (for example^ mathematical fynctlons) for which 
It Is more efficient Cthoygh less general) to pmss a 
limited set of parameter valyes via registers* Up to 
eight <64 bit values) can be passed In registers X2 - X9. 
The first paraieter valye *ioyld be in X2# the secoi^d In 
X3> etc. If a Coyble Mord valye (say^ double precision) 
Is required^ it us^s tuo consecytlve registers* The 
specific register ysed for a roytlne may be Inferred from 
the type of the parameter. For example^ SQRT(X) y|ll yse 
X2 lihlie OSQRTtO) Ml M yse X2 and X3* These ryles apply 
to the foil Oiling data types as parameters: 

1-7 byte Integers 

8 byte Integers 

Real 

Dcyble Precision 

Complex 

Retyrn registers for register call functions (see S.2*3) 
must not be saved In calling them* 

no rules are specified for character* boolean or pointer 
data pending Identification of functions using these 
argument types that are of general utility* 

The register c«ll entry point Is not bound by ttie 
conventions of the common calling sequence* 

Al I register call functions Intended for general use iiust 
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also offer an entry point tliat accepts ttie coiifiBon ceiling 
sequence C5.2 stove) and ref erenceabia fey a CALiSEG 
Instryct ion« 



3 • 3 IMI£££EQ 2ii£I«£IL£-yiiii£ 



Inter pro<iuct file scaring l^etMeen execytlng sybsystems 
^111 be addressed* It )#iil specify ynder nhat conditions 
a product i«ili be abie to perform I/O on a file declared 
by anotlser product* It Mlli aiso B44r^ss ciosing and 
flyshlng of files at Job sttp terailnation i#hen 
inter I angyage files mre being ysed* 



5.4 5IQS4££-l3M4£il!£iI 
pyrpose 



In QTdBT ttiat yser object code frcai different compilers 
can co-exist In one Job step lilillt yslng a limited nymber 
of sagroents# certain conventions niyst be observed* 

Each yser will liave a | lilted nyaiber of segments. This 
means tliat object code from different compilers myst be 
able to stiare certain data segments. 



5.4.1 STANDARD STACK FRAflE 



Tills section describes tf^e standard stack frame m^IcIi mMI 
be set yp In conjyncticn mI tli ttie CALL Instruct Ion* Tlie 
pyrpose of standardizing ttie stack frame layout Is to 
provide common traceback &nd debugging Interfaces. At the 
same time^ ailoMance Is made for a mini mum frame for 
langyages such as batch mode FORTRAN^ Mltl^ extensions for 
the complexity of languages such as PL/ I. 

A stack frame consists of two areas* 

1. The SAyB area. 

2. The "environmental** area. 

The save area belongs to the caller^ the **environroental** 
area belongs to the callee and both exist In the 
appropriate rings* 
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f.4#l.l It&^^hM&k 

Tracafeack Is considered t^ be ttie lowest level of 
debygging and as such feqylres the support of both the 
loader an<l tlie compl lers/asseipbier • Hlnlffiyj^ tracebacit 
Information mIII eii«ays be produced to facilitate so^e 
tracing frouj with In the s^stero. 

The compliers/ assembler wlM prooyce tracebacic tables In 
the object modyle which correlate object-code address of 
entry points anc calls *ilth soyrce-code procedure naiaes 
and line numbers. The loader nil! maintain the relation 
of these object code ^4&T0Bses* yhen traceback Is 
re^iulred^ these traceback tables^ plus the stacks mIII be 
Interpreted to give the source-code names and line nuisbers 
associated with the PVAs obtained during traceback* In 
full traceback inode entries will exist for each line or 
source stataiBenti In ilnliiiuffl traceback mode only entry 
points and calls are n^onltored* 

5 . 4 • 1 . 2 siitiij«£haic. jsa— OiSEisj 

(See Glossary for definitions.) 

It Is not the Intention of this standard to dictate 
whether cojiiplltd code Kill reference globals via the 
static chain or a display. Either Is persiltted and must 
be maintained by the software. Notes this only applies to 
calls to a nested procedure and hence Is Intr al anguage. 

5.4.2 CHAINS 01= ON-CONDITIOM PROCESSORS 

Software conventions for a standard on-condl tlon processor 
chain format are reoulred to ensure that on-conditlons can 
fee processed correctly. 

The on-condltlon flag COCF) in the saye area Is used to 
Indicate that the stack frame has associated on*-condl tlon 
processors. The first eight bytes of the stack fraise 
(pointed to by the current stack fraffle CCSF) of the save 
area) are reserved for the head of the on-condl tion 
processor chain. All objmct code generators must 
acconifliodate the head of chain reservation. If the OCF is 
set in the save area# the eight bytes pointed to by CSf Is 
the head of the on-condltlon processor chain. If the QCF 
Is not set* the contents of the eight bytes Is undefined. 
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5.4*3 DYNAMIC NON-STACK STORAGE 

NOS/VE provides the CBp&bil ity of creating nen segrBtnts 
during prodyct executlof^. Since this Increases ttie number 
of sefments In sctlve use and potential l3f cayses a 
performance degradationf Its use stioyld be limited to 
situations uliere the alternatives are less satisfactory. 

5 .4 .3.2 El^&izt&^itiQQ^M(^mLa^lkutm& 

The fyndajiier^tal support for f Ixed-posI ticn 4fnmm\G storage 
allocation Is provided by the CYBIi ALLOCATE statepent 
witfi no IN option* 

Products coded In CY8IL and needing flxed-"posltlofi dyaaiulc 
storage shoyid use ttse ALLOCATE stateiaent directly. 
Products not coded In CYB3L and needing fixed-position 
dynajiilc storage Jisay either^ 

1) Inciyde CY8IL subroutines containing the appropriate 
ALLOCATE st«tc»ents> or 

2) use a set of conunon routines which Mill provide a CHH 
coflipatlbie Interface to the ALLOCATE statement. 

5 • 4 « 3 • 3 )igtL^hl&ztBSltL&uJlmxmLsi^ltaLMSi& 

Variable-position dynamic storage Is not currently planned 
for support. 

This section Mill define liiodules Mhlch will be available 
for general use. 

Math Routines 

For a detailed account of the math routines to be provided 
see C180 Comwon Modyles Math Library (CMML) ERS with DCS 
log 10 S2929. The routines «IH offer both a register 
calling sequence and the coi^mon calling sequence. Entry 
point naines Mill n^eet the specifications of section 4.I.I. 

Numeric Conversion Routines 
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Roytlnes mI 11 be proyldea for ail pro4ucts i^ompHmt or 
runtlBie s^stafl;s) to perform nyneric Inpyt and output 
conversion* Tliis wili ensyre tliat tlie same nuaerlo 
representation matches t)ie same internal bit valye bf all 
processors* See also €180 common tiiodyies math librMfy 
iCnni) ERS witr^ OCS lof id S2929, and CHHl 
Asseaibly-Ianguage Sypport Systew ERS mith OCS log ID S3410. 



TO 

4- 



f^ROH 

Integer 

Real 

Lonsreal 

ASCII 

ASCII 
Cnondec. ) 

BOP* 

Unpacked 
dec imat 
tr all i ng 
si dn 
cowblned 
1^0 1 Jerlth 

NufPber 170 



I 


R 


L 


n 


e 





t 


a 


n 


e 


1 


g 


§ 




r 


e 




e 


r 




a 
1 



A 
S 

c 
I 
I 

Cnondec*) 



8 OP* 



X X 

XCl) 



XCl) 
XCl) XU) XC2) 



trail Ina 
sign 

CO « Is I na- 
tion 
hotierltti 



Hyffibar 
170 



*lnclydes afi 80P types except: alphanymer Ic 

(1) there are additional roytlnes for handling real and longfeal conversions 
to and from asci i in piecemeal fashion 



C2) translation* move^ etc. 
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Utilities 

A set of cofflwcfi ytllities Hill bm proVMeil to carry out 
the followlns fiinctJonss 

• Diagnostic Handling - tlie for»attlns of diagnostic 

lin^s of oiitpyt sn4 tlie constryction of tlit diagnostic 
1 1 stings* 

« Scarce listing fcreattlns ~ the formatting of the 

source listing inclydlng oytpyt of the source lines to 
a print file. 

Storage roap/Attr ibute/Cross Reference listings - the 
forJTsattlng cf this listing and oytpyt of Its contents 
to a print file. 

. Cofipiier Usages Statistics - the generation of ysage 
statistics messages. 
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6.0 £LOSSMI«fl£.I££fiS 



In Kfitins the Systeui Interface Standard it became 
necessary to clarify ttie meaning cf certain moT4Mm This 
glossary contains these words uhlch re^^yfred 
ci ar If I catlcn* The list Mill be extended* 

-a~ adjective 
-n- noun 
-V- verb 

Binary -a^ Of base 2. Mot to be ysed Mithoyt 

<!ual If Icatlon to nean the object code 
cytput from a compiler* Note object 
code flies are one of many different 
forms of binary files. 

Boolean •n- Data type which can hold the values 

•»trye** or "false*** 

FORTRAN -n- Boolean data but re^iulred to occupy a 
Boolean full coisputer )«ord« 

Diagnostic -n- Generally a part of a larger entity^ 

such as llstable outputs as opposed 
to an error ipessage> Nhlch Is 
generally a summary of a command* 
Diagnostics are generally Issued by a 
number of the product set^ such as a 
compiler* See also ~ error mess »u%* 
Example* A compiler may provide a 
single error message telling hoti many 
errors occurred during compilation 
and produce a diagnostic for each 
compilation error* 

Display -n- A mechanism for accessing global 

varlaoies of a program using a table 
of stack frame pointers? one pointer 
for each accessible scope and one 
table for each active scope* 

Error Message -n~ Generally a summary of a commands as 

opposed to a diagnostic^ Mhlch Is 
generally a part of a larger entity^ 
such as 1 1 stable output* The error 
message Is generally Issued by the 
operating system or by a product via 
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tlie operating systero* See also - 
diagnostic for an example* 
Invoke -v- Applies only to spirits^ wltufees^ 

etc* Procedyres &re called* 

Job Step -n- A Job step Is the work 6QnB as a 

result of a single command In the 
deck/file* Job steps eKecyta 
$e<iu^ntl al If ««lthln a Job* 

Load Module -n- Object Inforiiatlon Prodyced by object 

library generator and Input to the 
loader or back into object library 
generator* Load »}odyies are designed 
to facilitate processing bf tiie 
loader . 

Object Hodyle -n- An object module Is a ynit containing 

code and/or data definition that Is 
prodyced by coispllers* 

Object Program -n- An object program Is a set of object 

fflodules organized to perform some 
specific function (e*g*9 compile 
COBOL statements)* An object PtQur^m 
Is prepared for execution by the 
loader* 

procsssCIng) -¥- Computing). Unrestricted to mean 

either hardware or softi«are* 

Processor -n- Restricted to hardware CPU or PPU* 

May be used for software If 
sufficiently uuallfied^ e*g* language 
processor. 

Product -n- Any part of the standard softi«are 

«hich Is covered by the System 
In erf ace Standard* 

Product Set -n- That part of the System i*hlch Is not 

part of the Operating System* 

record -n- A unit of data on a file* e*g* a 

card image# line Image* Not to be 
used without qualification If meaning 
a «CY3IL*' record or ••SCt'* record* 

Standard -n- Pi ural -Standard not Standards J^hen 
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us€(l in tise sense ©f ttte Syste« 
Interface standard* 

Static chain -n- A asechanlsro fcr accessing glcl^ai 

variables of a prcgram using links 
through the stack fraroes. 

Syste«i -n~ AH products Cq«y*l operating %s a 

Mliole - to be distinguished froRi 
Operating S^steia. 

Task -n- A task Is an Instance of execytlon of 

an object program* Hultlple tasks 
can execute ulthln a single Job 
step* Each task has Its oun address 
space Cset of ineincri segmentsl* 
Tasks may be Initiated elttier 
s y n chr o n o us I y or ms y n ch r on ous I y to 
tJie Initiating taskt 
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